Usage

Documentation stub — work in progress.

TUI

szpont              # repo view when the current directory is a repo with sessions
szpont --global     # all sessions across all repos
szpont --repo PATH  # sessions of a specific repo

Headless commands

szpont sessions [--json] [--all] [--repo PATH]   # list sessions
szpont limits [--json]                           # rate-limit / usage state
szpont complete <tool> <session-id>              # mark completed
szpont reopen <tool> <session-id>                # clear the completed mark
szpont install-mcp [--tool all|claude|codex|kimi] [--dry-run]
szpont mcp                                       # MCP server on stdio
szpont completions <shell>                       # shell completions

Shell completions

zsh with Homebrew, for example:

szpont completions zsh > /opt/homebrew/share/zsh/site-functions/_szpont

Session status

The STATUS column shows:

Status	Meaning
`RUNNING`	the tool is working
`BLOCKED`	waiting for your input
`IDLE`	open at the prompt
(empty)	session not loaded in any process