Use this skill for service operations only. DO NOT use this skill for CLI implementation lifecycle work such as creating, testing, updating, troubleshooting, validating, removing, or documenting the CLI tool itself; delegate those tasks to cli-tool-expert. Execute claude-code-sessions operations using the `claude-code-sessions` CLI tool. Query and analyze session data from ~/.claude -- projects, sessions, conversations, tool calls, subagents, todos, skills, and timeline. Triggers: claude-code-sessions, cc-sessions, session history, tool call history, session data, code session activity, session timeline, subagent history
Resources
1Install
npx skillscat add adbertram/cli-tools/cc-sessions-cli Install via the SkillsCat registry.
SKILL.md
Execute claude-code-sessions operations using the `claude-code-sessions` CLI. All session data queries should use this CLI.
The `claude-code-sessions` CLI follows this pattern:
```bash
claude-code-sessions [arguments] [options]
```
**MANDATORY: Consult the adjacent `usage.json` at `/_repo/skills/-cli/usage.json` before executing ANY `claude-code-sessions` command.**
This file contains complete command syntax, all arguments, all options, and usage instructions for every command. Never guess at command syntax.
- **auth** -- Authentication status (login, logout, test, status)
- **projects** -- List and query projects (list, get)
- **sessions** -- List, get, and search sessions (list, get, search)
- **conversations** -- List and view conversations (list, get)
- **subagent-activity** -- Query subagent invocations (list, get)
- **tool-calls** -- Query tool call history (list, get)
- **todos** -- Query todo items (list, get)
- **skills** -- Query skill invocations (list, get)
- **timeline** -- View activity timeline (list, consolidated, get)
</essential_principles>
**`usage.json`** -- Complete command tree with arguments, options, defaults, and usage instructions for every command.
</reference_index>
- Command executes without error
- Output is displayed in requested format
- Correct command and flags used (verified against usage.json)
</success_criteria>
| Task | Command |
|---|---|
| List projects | claude-code-sessions projects list |
| List sessions | claude-code-sessions sessions list |
| Search sessions | claude-code-sessions sessions search <query> |
| List tool calls | claude-code-sessions tool-calls list |
| View timeline | claude-code-sessions timeline list |
| List subagent activity | claude-code-sessions subagent-activity list |
| List skill invocations | claude-code-sessions skills list |
| </quick_start> |