chasm-cli 2.0.0

Universal chat session manager - harvest, merge, and analyze AI chat history from VS Code, Cursor, and other editors
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

# Codex CLI Setup


OpenAI's Codex CLI sessions are auto-detected from the Codex data directory.

## Prerequisites


- [Codex CLI](https://github.com/openai/codex) installed
- Active OpenAI API key

## Installation


```bash
# Install Codex CLI

npm install -g @openai/codex

# Set API key

export OPENAI_API_KEY=sk-...

# Verify

codex --version
```

## How It Works


Codex CLI stores sessions as JSONL files:

| Platform    | Path                             |
| ----------- | -------------------------------- |
| **Windows** | `%USERPROFILE%\.codex\sessions\` |
| **macOS**   | `~/.codex/sessions/`             |
| **Linux**   | `~/.codex/sessions/`             |

## Usage


```bash
# List Codex CLI sessions

chasm list sessions --provider codexcli

# Harvest

chasm harvest run --providers codexcli

# Watch for new sessions

chasm watch --agent codex
```

## Tips


- Codex CLI sessions include tool invocations (file edits, terminal commands)
- Sessions are stored in JSONL event-sourced format
- Use `chasm run codex` to launch Codex with automatic session capture