← ClaudeAtlas

ftown-sessionslisted

Observe and control other ftown CLI agent sessions on the same machine. Use the ftown-sessions CLI (~/.ftown/ftown-sessions) to list, create, read, and drive sibling sessions while running inside a ftown-managed Claude Code or Cursor Agent session.
fmktech/ftown · ★ 1 · AI & Automation · score 74
Install: claude install-skill fmktech/ftown
# ftown cross-session CLI **Prefer the CLI** — installed to `~/.ftown/ftown-sessions` whenever `ftown-bridge` is running. It reads `~/.ftown/bridge.json` automatically. ```bash ~/.ftown/ftown-sessions --help ``` Skill copy (same binary via wrapper): `scripts/ftown-sessions` in this skill directory. **Trust model:** anyone who can read `bridge.json` can control **every** ftown session on that bridge. ## Commands ```bash # List sessions (JSON) ~/.ftown/ftown-sessions list # Spawn a child agent (uses FTOWN_SESSION_ID for --parent) ~/.ftown/ftown-sessions create \ --shell cursor \ --prompt "Review the auth module and summarize" \ --workdir /path/to/repo \ --name auth-review \ --parent # Metadata ~/.ftown/ftown-sessions get <session-id> # Terminal output (JSON by default; add --plain for raw lines) ~/.ftown/ftown-sessions screen <session-id> --limit 200 # Search output (--offset/--limit paginate screen and grep) ~/.ftown/ftown-sessions grep <session-id> --pattern 'error|failed' --offset 0 --limit 100 # Type into another running session ~/.ftown/ftown-sessions keys <session-id> 'y' # Liveness ~/.ftown/ftown-sessions running <session-id> # Stop and remove a session (kept as a tombstone in the archive) ~/.ftown/ftown-sessions remove <session-id> # List archived (removed) sessions: id, name, removedAt, shellType ~/.ftown/ftown-sessions archive # Recreate a removed session from its tombstone (resumes the agent # conversation when a claude/cursor session id was