clawgs

name	clawgs
description	Extract clawgs.v2 JSON from Claude Code and Codex JSONL session logs and run the clawgs.emit.v2 thought-emission daemon over stdio. Use when asked to parse agent transcripts, normalize .jsonl sessions, auto-discover current Claude/Codex logs by cwd, or generate thought updates from live session snapshots for downstream tools.
license	MIT

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-v2.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.v2. Full field definitions and sample output are in references/schema-v2.md.

Release Metadata

Current crate release target: 0.2.0.

• 0.2.0 is the canonical clawgs.v2 / clawgs.emit.v2 schema and protocol release.
• Release history is tracked in CHANGELOG.md.
• Tag and crates.io publish steps are tracked in RELEASE.md.