aisync
- Repo stars 39
- Author updated Live
- Author repo awesome-omni-skill
- Domain
- AI
- Compatible agents
-
- Claude Code
- Cursor
- Cline
- Codex
- Windsurf
- Gemini CLI
- +20
- Trust score
- 88 / 100 · community maintained
- Author / version / license
- @diegosouzapw · no license declared
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Required · GitHub
- Operating systems
- macOS · Linux · Windows
- Runtime requirements
- Python
- Permissions
-
- Read-only
- Write / modify
- Env read
- Network behavior
- External requests
- Install commands
- 26 variants
Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.
Heads up: 未限定 allowed-tools,默认拥有全部工具权限。
---
name: aisync
description: Sync AI coding sessions from 14 tools (Claude Code, Codex, Cursor, Aider, Cline, Gemini CLI, Con…
category: ai
runtime: Python
---
# aisync output preview
## PART A: Task fit
- Use case: Sync AI coding sessions from 14 tools (Claude Code, Codex, Cursor, Aider, Cline, Gemini CLI, Continue, Copilot, Roo Code, Windsurf, Zed AI, Amp, OpenCode, OpenRouter) to Obsidian vault as markdown notes. Use when user wants to backup, export, or sync their AI chat sessions to Obsidian, set up automatic syncing, check sync status, or troubleshoot sync issues. Handles secret redaction automatically. Cross-platform (macOS, Linux, Windows)..
- Inputs: target material, constraints, expected output, and acceptance criteria.
- Evidence boundary: follow “Supported Providers (14) / Output Formats (5) / CLI Commands” and do not present inference as author intent.
## PART B: Execution result
- **01** The card summarizes the use case; runtime output centers on “Sync AI coding sessions from 14 tools (Claude Code, Codex, Cursor, Aider, Cline, Gemini CLI, Continue, Copilot, Roo Code, Windsurf, Zed AI, Amp, OpenCode, OpenRouter) to Obsidian vault as markdown notes. Use when user wants to backup, export, or sync their AI chat sessions to Obsidian, set up automatic syncing, check sync status, or troubleshoot sync issues. Handles secret redaction automatically. Cross-platform (macOS, Linux, Windows).”.
- **02** When the source has headings, the agent prioritizes “Supported Providers (14) / Output Formats (5) / CLI Commands” so the result follows the author’s structure.
- **03** Typical output includes task judgment, concrete steps, required commands or file edits, validation, and follow-up options.
- **04** Risk context follows the fingerprint: read files, write/modify files, read environment variables; may access external network resources; requires GitHub API keys.
## Running Rules
- read files, write/modify files, read environment variables; may access external network resources; requires GitHub API keys.
- Validate with a small sample before expanding scope.
- Return the result, validation criteria, and next iteration options. The source does not require a stable slash command. After installation, invoke the skill by name and describe the task.
Name target files or source material, expected output, forbidden changes, and whether network or shell access is allowed. Permission fingerprint: read files, write/modify files, read environment variables.
Start with a small task and check whether the result follows “Supported Providers (14) / Output Formats (5) / CLI Commands”. Inspect diffs, logs, previews, or tests before expanding scope.
Confirm the final output includes a concrete result, evidence, and next action. If it stays generic, tighten inputs, boundaries, and acceptance criteria.
---
name: aisync
description: Sync AI coding sessions from 14 tools (Claude Code, Codex, Cursor, Aider, Cline, Gemini CLI, Con…
category: ai
source: diegosouzapw/awesome-omni-skill
---
# aisync
## When to use
- Sync AI coding sessions from 14 tools (Claude Code, Codex, Cursor, Aider, Cline, Gemini CLI, Continue, Copilot, Roo Co…
- Use it when the task has clear inputs, repeatable steps, and validation criteria.
## What to provide
- Target material, scope, expected result, and forbidden changes.
- Whether network, commands, file writes, or external services are allowed.
## Execution rules
- Organize steps around “Supported Providers (14) / Output Formats (5) / CLI Commands” and keep inference separate from source facts.
- read files, write/modify files, read environment variables; may access external network resources; requires GitHub API keys.
- Validate with a small sample before expanding the task.
## Output requirements
- Return the deliverable, key evidence, validation method, and next action.
- Mark missing information as unknown; do not invent commands, platforms, or dependencies. The author source anchors workflow facts; repository files anchor sources and commands; Fluxly only adds fit, limitations, and quality judgment.
skill "aisync" {
input -> user goal + target files + boundaries + acceptance criteria
context -> Supported Providers (14) / Output Formats (5) / CLI Commands
rules -> SKILL.md triggers / order / output contract
runtime -> Python | read files, write/modify files, read environment variables | may access external network resources
guardrails -> requires GitHub API keys + small-sample validation + diff/log review
output -> copyable result + checklist + next iteration
} AI Sessions Sync v2.2.0
Sync AI coding sessions from 14 different tools to multiple output formats with analytics, search, and automatic secret redaction.
Supported Providers (14)
| Provider | Location | Output Folder |
|---|---|---|
| Claude Code | ~/.claude/projects/**/*.jsonl |
claude-code-sessions/ |
| Codex CLI | ~/.codex/sessions/**/*.jsonl |
codex-sessions/ |
| Cursor | ~/.cursor/projects/**/agent-transcripts/*.txt |
cursor-sessions/ |
| Aider | ~/.aider.chat.history.md |
aider-sessions/ |
| Cline | VS Code globalStorage | cline-sessions/ |
| Gemini CLI | ~/.gemini/ |
gemini-cli-sessions/ |
| Continue.dev | ~/.continue/sessions/ |
continue-sessions/ |
| GitHub Copilot | VS Code globalStorage | copilot-chat-sessions/ |
| Roo Code | VS Code globalStorage | roo-code-sessions/ |
| Windsurf | Codeium/Windsurf app data | windsurf-sessions/ |
| Zed AI | ~/.config/zed/conversations/ |
zed-ai-sessions/ |
| Amp (Sourcegraph) | VS Code globalStorage | amp-sessions/ |
| OpenCode | ~/.local/share/opencode/ |
opencode-sessions/ |
| OpenRouter | ~/Downloads/openrouter*.json (exports) |
openrouter-sessions/ |
Output Formats (5)
| Format | Description |
|---|---|
obsidian |
Markdown with YAML frontmatter for Obsidian |
json |
JSON files (single or per-session) |
jsonl |
JSON Lines for streaming/processing |
html |
Static website with search |
sqlite |
SQLite database with full-text search |
CLI Commands
🤖 AI Sessions Sync v2.0.0
COMMANDS:
sync Sync sessions to output format(s)
search Search across all sessions
stats Show usage statistics
report Generate detailed report
status Show detected sessions
providers List supported AI tools
outputs List output formats
config Get/set configuration
QUICK START:
aisync sync # Sync to Obsidian
aisync sync -f json html # Sync to JSON + HTML
aisync search "function" # Search sessions
aisync stats # View statistics
aisync sync - Sync Sessions
aisync sync [options]
OPTIONS:
-o, --output DIR Output directory (default: auto-detect vault)
-f, --format FORMAT Output format(s): obsidian, json, jsonl, html, sqlite
-p, --provider PROV Only sync specific provider(s)
--no-analyze Skip analytics computation
--json Output results as JSON
EXAMPLES:
aisync sync # Sync to Obsidian
aisync sync -o ~/ai-sessions # Custom directory
aisync sync -f obsidian sqlite # Multiple formats
aisync sync -p claude-code cursor # Specific providers
aisync search - Search Sessions
aisync search <query> [options]
OPTIONS:
-p, --provider PROV Filter by provider
-l, --limit N Max results (default: 20)
--regex Use regex pattern
--json Output as JSON
EXAMPLES:
aisync search "async function" # Simple search
aisync search "error" -p cursor # Filter by provider
aisync search "def \w+\(" --regex # Regex search
aisync stats - View Statistics
aisync stats [-f text|json]
OUTPUT INCLUDES:
- Total sessions and messages
- Token usage estimates
- Sessions by provider
- Top programming languages
- Activity patterns
aisync report - Generate Report
aisync report [-o FILE]
REPORT INCLUDES:
- Overview (sessions, messages, tokens)
- Insights (productivity patterns, streaks)
- Breakdown by tool and language
Other Commands
aisync status # Show vault location and session counts
aisync providers # List all 12 supported tools
aisync outputs # List output formats
aisync config # Get/set configuration
aisync config OBSIDIAN_VAULT "~/vault" # Set vault path
Installation
Run the installer:
cd ~/.claude/skills/aisync/scripts
./install.sh
This will:
- Install Python library and CLI
- Set up automatic syncing (platform-specific)
- Run initial sync
Cross-Platform Support
| Platform | Scheduler | Auto-Install |
|---|---|---|
| macOS | launchd | ✅ Automatic |
| Linux | systemd/cron | ✅ Automatic |
| Windows | Task Scheduler | 📋 Manual (instructions provided) |
Configuration
# Option 1: Environment variable
export OBSIDIAN_VAULT="/path/to/your/vault"
# Option 2: Config file
echo 'OBSIDIAN_VAULT="/path/to/your/vault"' > ~/.aisync.conf
# Option 3: CLI
aisync config OBSIDIAN_VAULT "/path/to/vault"
Features
Analytics
- Token usage estimation
- Language detection in code blocks
- Activity patterns (peak hours, streaks)
- Usage insights
Search
- Full-text search across all sessions
- Regex support
- Filter by provider, date
- Find similar sessions
Secret Redaction
Automatically redacts 20+ patterns:
- API keys (OpenAI, Anthropic, Google, AWS)
- GitHub tokens
- Database URLs
- Private keys
- JWT/Bearer tokens
Troubleshooting
| Issue | Solution |
|---|---|
| No sessions found | Check if AI tools are installed and have sessions |
| Sync not running | Run aisync status to check |
| Vault not found | Set OBSIDIAN_VAULT env var |
| Search not working | Ensure sessions are synced first |
Library Files
The skill includes a modular Python library in lib/:
lib/
├── __init__.py # Main API (sync_all, etc.)
├── cli.py # Command-line interface
├── models.py # Data models (Session, Message)
├── redact.py # Secret redaction
├── search.py # Search functionality
├── parsers/ # 12 provider parsers
├── outputs/ # 5 output formats
└── analytics/ # Analytics & insights
Decide Fit First
Design Intent
How To Use It
Boundaries And Review