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.