skl gives you one interface for the AI coding sessions and agent skills on your machine. Session commands work locally and do not require a Skillsync account.
Looking for a visual interface on macOS? Download the Skillsync desktop app. The rest of these docs cover the CLI.
Install
macOS and Linux:
curl -fsSL https://install.skillsync.com/install.sh | sh
Windows PowerShell:
irm https://install.skillsync.com/install.ps1 | iex
The installer puts skl on your PATH and runs first-time setup when it has an interactive terminal. Confirm the installation:
skl --version
You can run setup again at any time. It offers to sign in and install shell completions.
skl init
Signing in is optional for local sessions. It is required when you browse, install, sync, or publish skills through Skillsync.
Find local sessions
List sessions across the supported coding agents:
skl list
Narrow the list to a project or agent:
skl list --cwd .
skl list --from codex
skl list --cwd . --from claude_code -n 20
By default, skl list searches all known session locations on this machine. It is not scoped to the current directory unless you pass --cwd.
Search session content
Pass a pattern for a non-interactive ranked search:
skl query "billing webhook"
skl query "billing webhook" --cwd .
Run skl query without a pattern to open the interactive session picker.
Read a session
Use the ID printed by list or query. An exact title or unambiguous ID prefix also works.
skl view <session-id>
skl view <session-id>#5-12
Message ranges are 1-based and inclusive. Use #7 for one message, #5- from message 5 onward, or #-10 for the first ten messages.
Continue past work
Resume in the original coding agent:
skl continue <session-id>
Continue a copy in another supported agent:
skl continue <session-id> --with codex
Cross-agent continuation writes a new session in the target agent's native format. It does not modify the source session.
Add agent access with MCP
skl mcp lets an MCP-compatible agent search and read local sessions through structured tools. For Claude Code:
claude mcp add --transport stdio skl -- skl mcp
See /docs/mcp-server for other clients and the exact tool list.
Work with skills
Sign in before using Skillsync-hosted skills:
skl login
skl skills search "code review"
skl skills install @owner/skill-name
See /docs/skills for local scopes, updates, workspace sync, and publishing.
Next steps
- Read the /docs/cli-reference for every top-level command.
- Check /docs/transcript-support for session compatibility and the txcript project.
- Use /docs/troubleshooting when discovery, login, continuation, or MCP setup fails.