ps

omnisess ps

Show live Claude Code and Codex sessions as a process tree with ancestor lineage.

Usage

omnisess ps

JSON output (machine-readable, includes full ancestor chain with command args):

omnisess ps --json

Instructions

1. Check that the omnisess binary is available:

if ! command -v omnisess &>/dev/null; then
  echo "omnisess not found. Install it with:"
  echo "  go install github.com/psacc/omnisess@latest"
  exit 1
fi

2. Run the command:

omnisess ps "$@"

Notes

• macOS-only. On other platforms the command prints omnisess ps: unsupported on this platform (macOS only) and exits 0.
• Detects CLI Claude sessions (launched from a terminal, tmux, etc.), Claude Desktop agent-mode sessions, and live Codex sessions (any codex process holding its rollout file open — CLI TUI and Codex.app threads).
• Tree is rooted at shared ancestors (typically /sbin/launchd and tmux) so you can see which terminal, tmux pane, or desktop app hosts each session.

Example output

/sbin/launchd (1)
├─ /Applications/Cl (24125)
│  ├─ /Applications/Cl (24780)
│  │  └─ claude  c5b1bd94  my-project (c5b1bd94)  desktop  27s
│  └─ /Applications/Cl (44287)
│     └─ claude  12f1b011  my-app (12f1b011)  desktop  4h
└─ tmux (9050)
   ├─ /bin/bash (23512)
   │  └─ claude  b9f52b71  my-app (b9f52b71)  cli  58s
   ├─ /bin/bash (41200)
   │  └─ codex  019e88aa  my-project (019e88aa)  codex-tui  2h
   └─ claude  232347cd  ai-assistant-pyra (232347cd)  cli  12m