Skip to content
Skills Library
AI & agents · Research

sessions

/sessions

Search, browse, and read agent conversation transcripts across Claude, Codex, Gemini, and OpenCode. Use this skill to find previous sessions, recover context, or inspect what agents have done.

Repository
agi-cli ↗
Licence
Apache-2.0
Last repository change
27.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

Search, browse, and read agent conversation transcripts across Claude, Codex, Gemini, and OpenCode. Use this skill to find previous sessions, recover context, or inspect what agents have done.

Arguments

/sessions [search query or session ID]
Original author description

Search, browse, and read agent conversation transcripts across Claude, Codex, Gemini, and OpenCode. Use this skill to find previous sessions, recover context, or inspect what agents have done.

How it works

  1. Basic Usage
  2. Filters
  3. Reading Sessions
  4. Artifacts
  5. Live Tailing
  6. Cost & Duration
  7. Tips
Original SKILL.md headings · 113 lines, 551 words
SKILL.md preview
---
name: sessions
description: "Search, browse, and read agent conversation transcripts across Claude, Codex, Gemini, and OpenCode. Use this skill to find previous sessions, recover context, or inspect what agents have done."
argument-hint: "[search query or session ID]"
allowed-tools: Bash(sessions*), Bash(agents ps*), Bash(agents insights*), Bash(agents events*)
user-invocable: true
---

# Sessions Skill

Search and browse agent conversation transcripts. This skill teaches you how to use the standalone `sessions` CLI (`@phnx-labs/sessions-cli`) effectively. `agents sessions` was removed; running sessions are `agents ps`, and resuming one is `agents run auto --resume <id>`.

## Basic Usage

```bash
# Interactive picker: browse and search recent sessions
sessions

# List sessions from current project
sessions | head -20

# Search sessions by text
sessions "add auth middleware"

# Filter by project across all directories
sessions --project agents-cli --all
```

## Filters

| Filter | Example | Description |
|--------|---------|-------------|
| `--agent` | `--agent claude` | Filter by agent type |
| `--all` | `--all` | Include sessions from every directory |
| `--project` | `--project myapp` | Filter by project name |
| `--since` | `--since 2h` | Only sessions newer than this |
| `--until` | `--until 2026-01-01` | Only sessions older than this |
| `--limit` | `--limit 10` | Maximum sessions to return |
| `--sort` | `--sort cost` | Order by `cost`, `duration`, or `recent` (default) |
| `--teams` | `--teams` | Include team-spawned sessions |

## Reading Sessions

```bash
# Render session as markdown
sessions --markdown <session-id>

# Output as JSON
sessions --json <session-id>

# Include only specific roles
sessions --markdown --include user,assistant <session-id>

# Show only first/last N turns
sessions --markdown --last 10 <session-id>
```

## Artifacts

```bash
# List all files written or edited during a session
sessions artifacts <session-id>

# Read a specific artifact
sessions artifacts <session-id> <filename>
```

## Live Tailing

```bash
# Live-tail a session file (Claude and Codex only)
sessions tail <session-id>
# Press Ctrl+C to stop

# Or the unified viewer: resolves a session id OR a host-dispatch run (from
# `agents run --device`), and -f follows either (a session tail here is
# `sessions tail` under the hood)
agents events logs <id>      # show it
agents events logs -f <id>   # follow it
```

## Cost & Duration

Every session is priced offline at scan time (`costUsd`) and its wall-clock
runtime is stored (`durationMs`). Both appear in `--json` output, and the list
can be sorted by either.

```bash
# The 10 most expensive sessions, anywhere
sessions --all --sort cost --limit 10

# Longest-running sessions in this project
sessions --sort duration

# Per-session cost in JSON
sessions --all --sort cost --json | jq '.[] | {shortId, agent, costUsd, durationMs}'
```

Use `agents insights cost` for a rollup (daily $ histogram, top sessions,
per-agent/project/day breakdown):

```bash
agents insights cost                  # daily histogram + top sessions + per-agent breakdown
agents insights cost --since 30d       # last 30 days
agents insights cost --by project      # group by project instead of agent
agents insights cost --by day --json   # machine-readable daily rollup
```

`agents insights cost` answers "how much did this cost?"; `agents view` answers "how
much quota / rate limit is left?" — different commands.

## Tips

- Use `agents ps` to find sessions running right now across terminals, teams, cloud, and headless agents
- Use `--teams` to see what team-spawned agents are doing
- Use `--since 1h` for recent activity
- Use `--sort cost` / `--sort duration` to find your priciest or longest sessions
- `agents insights cost` for spend rollups; `agents view` for rate-limit status
- Combine filters: `sessions --project myapp --since 1d --agent claude`

Versions

RepositoryScoreLicence
This page · phnx-labs/agi-cli100Apache-2.0
slopus/happy100MIT
Insilico-org/plsi100MIT
adelrodriguez/skills100MIT
leeguooooo/chrome-use95Apache-2.0
gregoryho/arcforge90MIT
centauri-ai/coslash87MIT

Database snapshot: 13.11.2026 · package version 0198c19bed6b (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100agent-sessions
    Search, list, and resume AI agent sessions across Claude Code, Codex CLI, Gemini CLI, opencode, Hermes Agent, and Cline CLI. Use when the user asks to find a past conversation, search session history, resume a previous session, list recent agent activity, or check what was…
  • 100coding-agent-sessions
    Finds, reads, and reconstructs coding-agent sessions across Codex, Claude, OpenCode, OMO/Senpi, and other local agent logs. Use when asked to find or search past sessions, transcripts, or subagent runs, or to recover what an earlier session did.
  • 100sessiondex
    This skill should be used when finding, listing, or reading past AI agent sessions across Codex, Claude Code, OpenCode, and Pi from one local full-text index. Triggers on "recent sessions", "recent Codex sessions", "what did I work on", "find the session where", "which agent did…
  • 100opencode-session-db
    Read OpenCode sessions, messages, and tool outputs directly from the SQLite database at ~/.local/share/opencode/. Use when asked to "read opencode sessions", "query opencode db", "find old sessions", "search session history", "read message history", "export session", "inspect…
  • 100portal-router
    Resolve and load any agent capability across the whole fleet from one place. Given an intent, finds the matching skill, command, or agent across Claude, Codex, Gemini, .agents, a-i--skills, OpenCode, and OpenClaw — then loads it through a single portal. Use for cross-agent skill…
  • 100acpmux
    Drive coding agents through acpmux, a daemon that keeps ACP agent sessions (Claude Code, Codex, OpenCode, pi, Gemini) alive as named sessions on this machine and on ssh peers. Use when a task says to run, prompt, wait on, or inspect an acpmux session, when ACPMUX_ENV=1, or when…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.