Sessions & Skills
List and manage agent sessions, tasks, and installable skills from the trickest CLI.
On this page9
The sessions and skill (alias skills) families manage the
conversational agent's runtime: chat sessions, tasks inside them, and the skill
library (markdown playbooks the agent can load).
trickest sessions
| Subcommand | Description |
|---|---|
sessions ls | List sessions |
sessions get <id> | Session details |
sessions create | Create a session |
sessions rm <id> | Delete a session |
sessions archive <id> | Archive a session |
sessions watch [id] | Poll until terminal state |
sessions tasks | Manage tasks within sessions |
sessions ls
trickest sessions ls
trickest sessions ls --status active[{"id":"54cc218a","title":"bench: complex-workflow run","status":"active","model":""}]| Flag | Description |
|---|---|
--status <status> | Filter: active, archived, deleted |
sessions create / get / archive / rm
trickest sessions create --title "Investigate DAST findings"
trickest sessions get 54cc218a
trickest sessions archive 54cc218a
trickest sessions rm 54cc218asessions watch
Poll session state until it reaches a terminal state (Ctrl+C to stop):
trickest sessions watch # watch the session list
trickest sessions watch 54cc218a # watch one sessionsessions tasks
Run trickest sessions tasks --help for task subcommands (create, list, update)
inside a session.
trickest skill
| Subcommand | Description |
|---|---|
skill ls | List installed skills |
skill get <id> | Skill details (includes full markdown body) |
skill install <key> | Install a skill by key |
skill rm <id> | Remove a skill |
skill ls
trickest skill lsReturns an array of skills. Each entry includes id, key, name,
description, and often the full content (the SKILL.md body) — the response can
be large. Prefer skill get <id> when you only need one skill.
skill install
trickest skill install api-testing --description "API test playbooks"
trickest skill install my-skill --content "$(cat SKILL.md)"| Flag | Description |
|---|---|
--name <name> | Display name |
--content <content> | Markdown with YAML frontmatter |
--description <desc> | Short description |
--tags <tags> | Comma-separated tags |