skillsync
Docs/Skillsync CLI

Local session compatibility

The coding-agent sessions skl can discover, read, search, and continue through txcript.

These docs cover the current Skillsync CLI. Local session support is powered by the open-source txcript project.

skl list, query, view, and continue come from txcript, Skillsync's open-source transcript library. txcript owns session discovery, parsing, conversion, and the compatibility matrix.

For current format internals and support added after your installed skl release, use the txcript documentation on GitHub.

Supported local sources

Current skl releases can discover sessions from these sources:

SourceAgent IDDefault location
Claude Codeclaude_code~/.claude/projects/
CoworkcoworkClaude app data under local-agent-mode-sessions/
Codexcodex~/.codex/sessions/
OpenCodeopencode~/.local/share/opencode/opencode.db
pipi~/.pi/agent/sessions/
Campfirecampfire~/.campfire/agent/sessions/
Cursor CLIcursor~/.cursor/chats/
Cursor desktopcursor_desktopCursor's user-data directory
Grok CLIgrok~/.grok/sessions/
Hermes Agenthermes~/.hermes/state.db
Ampamp~/.local/share/amp/threads/
Antigravityantigravity~/.gemini/antigravity-cli/

Use the IDs above with --from and --with. Friendly aliases such as claude are also accepted, but canonical IDs are more reliable in scripts.

Capabilities differ by source

Discovery, listing, search, and viewing work for sources with an available backing store. Continuing into another agent additionally requires txcript to write that agent's native format and the target agent to support resuming or importing it.

Amp and Hermes are source-only in the current CLI and cannot be continuation targets. Simple is an interchange document rather than a discovered local agent:

skl continue ./session.json --with claude_code
skl continue - --with codex

Cross-agent continuation creates a new session. The original transcript is never modified or removed.

Local-only behavior

The CLI does not upload coding sessions to Skillsync. It reads local stores and writes local target sessions when you run continue.

Two explicit boundaries are worth noting:

  • skl mcp returns local session data to the MCP client that invokes its tools.
  • Search uses a local SQLite cache containing session-derived searchable text. The cache lives in the platform cache directory and can be recreated.

Diagnose discovery

Start with a broad list, then narrow it:

skl list
skl list --from opencode
skl list --cwd /path/to/project

If a source is missing, confirm that its default store exists and that the current user can read it. See /docs/troubleshooting for common causes.