Clawgs

Purpose

Use this skill to run deterministic transcript extraction and daemonized thought emission outside the main app process.

Prerequisites

Rust toolchain with cargo
This skill checked out locally

Install

bash scripts/install.sh

Verify

bash scripts/check.sh

Core Command

target/release/clawgs extract --tool auto --cwd "$PWD"

Emit Daemon (stdio)

target/release/clawgs emit --stdio

Send one JSON sync message per line on stdin, read sync_result lines from stdout. Protocol details are in references/emit-protocol-v1.md.

Tmux Emit

Poll every live tmux pane it can find, build session snapshots automatically, and emit the same NDJSON envelope used by the stdio daemon:

target/release/clawgs tmux-emit --once
target/release/clawgs tmux-emit

Recommended shape: keep tmux-emit running as a daemon, let tmux hooks send immediate notify events, and keep the built-in interval as a slower reconciliation scan.

target/release/clawgs tmux-emit --interval-ms 60000
target/release/clawgs tmux-notify --event session-created

Recommended shared setup: keep the tmux hook block in this repo and source it from personal tmux configs instead of copying or symlinking an entire ~/.tmux.conf.

source-file "/path/to/your/clawgs/references/tmux-clawgs.conf"

The checked-in snippet is references/tmux-clawgs.conf. It starts one background clawgs tmux-emit daemon, wires tmux lifecycle hooks to clawgs tmux-notify, and uses these defaults:

socket: $HOME/.tmux/clawgs-tmux.sock
output log: $HOME/.tmux/clawgs-tmux.ndjson
error log: $HOME/.tmux/clawgs-tmux.err
reconcile interval: 60000 ms

Output shape:

first line: hello
each poll after that: sync_result
metrics.sessions_seen: number of live tmux panes scanned
updates[]: only panes that produced a new thought on that poll

tmux-emit uses pane metadata + captured pane text as terminal context. If the pane command looks like Claude or Codex, it also tries transcript discovery by cwd.

Useful Flags

--input <path>: parse a specific JSONL file instead of discovery
--tool <claude|codex|auto>: force or infer source format
--pretty: pretty-print JSON output
--include-raw: include raw parsed event excerpts for debugging
--max-actions, --max-task-chars, --max-detail-chars: output size controls

Output Contract

Schema version is clawgs.v1. Full field definitions and sample output are in references/schema-v1.md.