Usage

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 <claude|codex|kimi> <session-id> # mark completed
szpont reopen <claude|codex|kimi> <session-id>   # clear the completed mark
szpont install-mcp [--tool all|claude|codex|kimi] [--dry-run]
szpont mcp                                       # MCP server on stdio (used by the tools)
szpont completions <shell>                       # shell completions (bash, zsh, fish, …)

Global flags

--db <PATH>         # override ~/.szpont/szpont.db
--refresh-secs <N>  # idle rescan interval (default 15)
--no-watch          # disable the file watcher
--log <PATH>        # append warnings to a log file

Shell completions

zsh with Homebrew, for example:

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

Session status

The STATUS column shows: