Expand description
omni-dev sessions — track the Claude Code, Codex and pi.dev sessions running
across every terminal and VS Code window, via the daemon’s sessions service.
The subcommands split by role:
listis a read client (likeomni-dev worktrees list): it asks the daemon’ssessionsservice for the live set and renders it.hookis the feed sink: Claude Code (or Codex, with--agent codex) runs it per hook event; it reads the hook JSON on stdin, maps it to anobserve/endop, and fire-and-forgets it to the daemon socket. It must never block or fail a Claude turn — a missing daemon, a bad payload, or any other error is swallowed and it always exits 0.install-hooks/uninstall-hooksidempotently merge (or remove) the hook block in~/.claude/settings.json, preserving any hooks already there. When pi.dev is installed they also write (or remove) the generated pi extension in~/.pi/agent/extensions/, which reports straight to the socket (#1901), and when Codex is installed the same hook block, tagged--agent codex, in$CODEX_HOME/hooks.json— position-stably, since Codex trusts a hook by its index (#1907).install-wrapper/uninstall-wrapperare the same idea for Feed 4: they write the shim that VS Code’s Claude extension launchesomni-dev claude-wrapthrough, and point the extension’sclaudeCode.claudeProcessWrappersetting at it.
The register/heartbeat feed from the companion VS Code extension talks to the socket directly (like the worktrees companion), not through this CLI.
Structs§
- Hook
Command - The Claude Code / Codex hook sink: reads one hook event’s JSON on stdin and reports it to the daemon. Fire-and-forget and infallible-by-design.
- Install
Hooks Command - Installs the sessions-tracker hooks into
~/.claude/settings.json, plus the pi.dev extension when pi is installed and the Codex hooks when Codex is. - Install
Wrapper Command - Installs the
claude-wrapshim and points VS Code’s Claude extension at it. - List
Command - Lists the live cross-window set of running Claude sessions.
- Sessions
Command - Sessions: see the Claude Code sessions running across every terminal and VS Code window, kept live by the daemon.
- Uninstall
Hooks Command - Removes the sessions-tracker hooks from
~/.claude/settings.json, the pi.dev extension, and the Codex hooks. - Uninstall
Wrapper Command - Removes the wrapper setting and the shim it points at.
- Window
Command - Reports a window’s Claude embedding counts (the companion
windowfeed op). - Window
Unregister Command - Removes a window’s embedding report — the companion
window-unregisterfeed op made typed. Prints whether an entry was actually removed.
Enums§
- Hook
Agent - The agents whose hooks run
HookCommand. pi.dev reports through its own extension, so it has no hook variant. - Sessions
Subcommands - Sessions subcommands.