delphin

Delphin

Delphin (delphin) wraps an AI agent CLI in a PTY so the user can keep typing while it thinks: extra prompts queue, a pluggable heuristic arbiter decides send-now / enqueue / stream / interrupt, and every turn is logged to a local SQLite database. Repo: https://github.com/wuisabel-gif/Delphin

Recall past conversations (most common use)

The memory database lives at:

• macOS: ~/Library/Application Support/Delphin/delphin.sqlite3
• Linux: ~/.local/share/Delphin/delphin.sqlite3
• or wherever the user pointed --db.

Table agent_turns — columns: id, session_id, ts, direction (user | agent | system), verdict (send_now | enqueue | stream | interrupt | NULL), text, cwd.

Set DB="<path above>", then:

List recent sessions:

sqlite3 "$DB" "SELECT session_id, count(*) AS turns, min(ts) AS started FROM agent_turns GROUP BY session_id ORDER BY max(id) DESC LIMIT 10;"

Show one session's turns in order:

sqlite3 "$DB" "SELECT direction, COALESCE(verdict,''), substr(text,1,200) FROM agent_turns WHERE session_id='<SESSION>' ORDER BY id;"

Search across everything:

sqlite3 "$DB" "SELECT session_id, direction, text FROM agent_turns WHERE text LIKE '%<TERM>%' ORDER BY id DESC LIMIT 30;"

Present the user's own words verbatim — do not paraphrase stored turns.

Build & run

git clone https://github.com/wuisabel-gif/Delphin && cd Delphin
cargo build --release
./target/release/delphin -- claude                                   # wrap a real agent
./target/release/delphin --interrupt ctrl-c -- bash examples/mock-agent.sh   # no-model demo

Flags: --idle-ms N, --tick-ms N, --submit-newline, --live, --interrupt {esc|double-esc|ctrl-c|none|<literal>}, --db PATH, --no-log.

While the agent is thinking, ordinary prompts queue; a line containing an urgency word (stop, wait, no, actually, …) interrupts instead. With --live, ordinary busy prompts stream immediately into the wrapped PTY instead of queueing; this is most useful for rich TUI agents that accept type-ahead while generating.

Use --db <other.sqlite3> to make Delphin write into another tool's database (e.g. share memory with a companion app).