---
title: "Sessions & Skills"
canonical: https://trickest.com/docs/developer-tools/cli/sessions-skills
description: "List and manage agent sessions, tasks, and installable skills from the trickest CLI."
---

# Sessions & Skills

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).

<Info>
Skills are product concepts used by the in-app agent. This page documents CLI
commands only. For how agents use skills in the platform UI, see
[Agents](/platform/agents) on the marketing site.
</Info>

## `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`

```bash
trickest sessions ls
trickest sessions ls --status active
```
```json
[{"id":"54cc218a","title":"Investigate DAST findings","status":"active","model":""}]
```

| Flag | Description |
|---|---|
| `--status <status>` | Filter: `active`, `archived`, `deleted` |

### `sessions create` / `get` / `archive` / `rm`

```bash
trickest sessions create --title "Investigate DAST findings"
trickest sessions get 54cc218a
trickest sessions archive 54cc218a
trickest sessions rm 54cc218a
```

### `sessions watch`

Poll session state until it reaches a terminal state (Ctrl+C to stop):

```bash
trickest sessions watch              # watch the session list
trickest sessions watch 54cc218a     # watch one session
```

### `sessions 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`

```bash
trickest skill ls
```

Returns 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.

<Tip>
Filter with `jq` instead of dumping everything:
`trickest skill ls | jq '[.[] | {key, name, description}]'`
</Tip>

### `skill install`

```bash
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 |

## Related

<CardGroup cols={2}>
  <Card title="Agent Memory" icon="brain" href="/docs/developer-tools/cli/memory">
    Persistent notes the agent recalls across sessions.
  </Card>
  <Card title="Search" icon="magnifying-glass" href="/docs/developer-tools/cli/search">
    Find skills, tools, workflows, and more in one query.
  </Card>
</CardGroup>

---
_Markdown source of https://trickest.com/docs/developer-tools/cli/sessions-skills._