Run skl --help or skl <command> --help for the exact options supported by your installed version.
Local session commands
Session discovery, conversion, search, and continuation are provided by txcript and mounted directly into skl. Session content stays on this machine unless you explicitly give it to another process, such as an MCP client, or sync it with skl sync.
skl list
List local sessions, newest first.
skl list
skl list --cwd <directory>
skl list --from <agent>
skl list -n 20 --since 2026-08-01
| Option | Effect |
|---|---|
--from <AGENT> | Include one coding agent only. |
--cwd <DIR> | Include sessions recorded in or below a directory. |
-n, --limit <N> | Limit the number of results. |
--since <DATE> | Include sessions on or after an RFC 3339 timestamp or YYYY-MM-DD. |
--until <DATE> | Include sessions on or before an RFC 3339 timestamp or YYYY-MM-DD. |
Without --cwd, the command searches every supported session store on the machine.
skl query
Search local transcript content. A pattern prints ranked results; no pattern opens an interactive picker.
skl query "relay bug"
skl query "relay bug" --cwd . --from opencode
skl query
The interactive picker continues the selected session when you press Enter. Pass --with <AGENT> to continue it in another agent.
skl view
Render a local session as compact text.
skl view <id-or-title>
skl view <id-or-title>#5-12
skl view <id-or-title> --from claude_code
Ranges are 1-based and inclusive: #7, #5-12, #5-, and #-10 are accepted.
skl continue
Resume a local session in its original agent or create a translated copy for another agent.
skl continue <id-or-title>
skl continue <id-or-title>#5-12 --with codex
skl continue <id-or-title> --with claude_code --no-resume
skl continue <simple-document> --with opencode
| Option | Effect |
|---|---|
--with <AGENT> | Continue in a different agent. Required for a Simple document. |
--from <AGENT> | Scope local ID or title resolution to one source agent. |
--out <DIR> | Write the converted session under a directory and do not launch it. |
--no-resume | Write the session without launching the target agent. |
Same-agent continuation resumes the original session. Cross-agent or ranged continuation creates a new local session and leaves the source unchanged.
Session sync
Send one local session to Skillsync or work with sessions already there. Requires login. See /docs/session-sync for sharing semantics.
skl sync
Sync one session as a thread you own. Shortcut for skl remote sync; the arguments are identical. Omit the session for an interactive picker.
skl sync <id-or-title>
skl sync <id-or-title> --workspace <slug> --workspace <slug>
skl sync <id-or-title> --private
skl sync <id-or-title> --dry-run
| Option | Effect |
|---|---|
--workspace <SLUG> | Share with this workspace. Repeat for the complete desired set; replaces the previous set. Conflicts with --private. |
--private | Remove every workspace share. |
--dry-run | Validate and print what would be sent. Uploads nothing. |
With neither sharing flag, a first sync uses the set-default workspaces (private if none) and a re-sync keeps its existing shares. Sessions under an ignored path are refused.
skl remote set-default
Workspaces a session's first sync from this machine is shared with. Replaces the previous default. No arguments prints the current one.
skl remote set-default <slug> [<slug>...]
skl remote set-default
skl remote set-default --clear
skl remote list
Your synced sessions, newest first. ls is an alias.
skl remote list
skl remote list --from codex -n 5 --json
| Option | Effect |
|---|---|
--from <AGENT> | Include one coding agent only. |
-n, --limit <N> | Show at most N sessions (1-50, default 20). |
--json | Print JSON instead of a table. |
skl remote open, view, continue, delete
Act on one synced session. <reference> is a local session ID (or prefix) synced from this machine, or a thread slug from skl remote list or a Skillsync URL.
skl remote open <reference>
skl remote view <reference>
skl remote continue <reference> [--with <agent>]
skl remote delete <reference> [--yes]
| Command | Effect |
|---|---|
open | Open the thread in the browser. |
view | Print the Skillsync copy as text, like skl view. |
continue | Resume in a local agent, like skl continue. A session still on this machine resumes in place; otherwise the copy is fetched and written as a new local session. --with picks the agent. |
delete | Delete the thread from Skillsync. Prompts unless --yes. Keeps the local session. rm is an alias. |
Authentication
Authentication is needed for session sync and skills, not for local session commands.
skl init
Run first-time setup or repeat it later. It offers to sign in and install shell completions.
skl init
skl login
Use browser login by default. Device login works on headless and SSH machines and is selected automatically where appropriate.
skl login
skl login --device
skl login --browser
SKL_TOKEN takes precedence over stored credentials when it is set.
skl whoami and skl logout
skl whoami
skl logout
logout removes the credentials file. It cannot remove an SKL_TOKEN environment variable.
Skills
skl skills lists local skills and works with skills hosted on Skillsync. skl skill is an alias.
skl skills list
skl skills search [query]
skl skills show <reference>
skl skills install <reference>
skl skills update
skl skills sync
skl skills upload [skill-or-path]
See /docs/skills for behavior and flags.
MCP
Run the combined local-session and Skillsync-skills MCP server over stdio:
skl mcp
See /docs/mcp-server for client setup and tool schemas.
Maintenance
skl completions
Generate completions for Bash, Zsh, Fish, Elvish, or PowerShell.
skl completions <shell>
skl update
Install the latest CLI release.
skl update
The CLI also performs a best-effort background update check at most once every 24 hours. Set SKL_NO_UPDATE_CHECK=1 to disable automatic checks.
skl guide
Print concise instructions intended for an AI agent using skl non-interactively.
skl guide
skl ignore
Manage paths hidden from the recent-session section of the bare skl home screen.
skl ignore <path>
skl ignore list
skl ignore remove <path>
skl sync refuses sessions under an ignored path and hides them from its picker. The ignore list does not filter skl list, skl query, skl view, skl continue, or MCP session tools. Use --cwd and --from to scope session commands.
Commands that do not exist
Current releases do not provide skl upload, skl auto, skl watch, or a functional skl workspace command. Sessions are published only by an explicit skl sync; there is no automatic or watched upload. upload exists only under skl skills upload and publishes a skill. Workspace sharing is set per session with skl sync --workspace and skl remote set-default.