chat-session-experimentallisted
Install: claude install-skill timothymeyers/discovery-tools
# Chat Session Experimental
Tested with **Discovery App Preview 0.15.21 on macOS**. The script also checks
VS Code, VS Code Insiders, and the Linux and Windows config folders, but those
have not been tested. Don't claim they work.
Everything except `archive` and `render` is read-only. The scripts use only the
Python standard library.
## Setup
1. Set `SKILL_DIR` to the parent folder of this `SKILL.md`. Don't assume a
checkout location.
2. Resolve the target project's **absolute** workspace root (`ROOT`). Default
to the current workspace folder.
3. Run `python3 "$SKILL_DIR/scripts/chat_sessions.py" <command> --workspace "$ROOT" [...]`.
Every command prints one JSON object. Read `ok` before doing anything else.
| Command | Purpose |
|---|---|
| `list` | All sessions for the project, newest first |
| `find --query "<keywords>" [--limit 5]` | Sessions ranked by relevance, with snippets |
| `render --session <id-or-prefix> [--theme discovery\|light\|dark] [--out PATH]` | Write the chat viewer HTML and return `url` |
| `archive [--session <id>] [--dry-run]` | Copy logs and telemetry into `.discovery/chat-sessions/` |
Shared filters: `--origin all|vscode-chat|copilot-cli`, `--interactive-only`
(skips automated engine and SDK runs), and `--storage-root DIR` (extra
`workspaceStorage` folder, can be repeated). Set `COPILOT_HOME` to override
`~/.copilot`.
Read [storage layout](./references/storage-layout.md) for where sessions are
stored on disk.
## Workflows
### Find a