swisper-prism-cli

prism — code-intelligence CLI for AI coding agents. Search, navigate, and reason about your codebase from the shell, with overlay-γ awareness for unpushed local edits.

Install

pip install --user swisper-prism-cli

Or with pipx (recommended on systems where pip --user is restricted):

pipx install swisper-prism-cli

Requires Python ≥ 3.11.

Auth

Generate a developer token at https://prism-console-swisper.web.app/settings, then either:

export PRISM_TOKEN="prism_<your-token>"

…or rely on ~/.claude.json:mcpServers.prism-hosted.headers.Authorization if you already have the Prism MCP server configured (the CLI piggybacks on that config).

Verify

prism ping

Expected: {"status": "ok", ...} plus a freshness timestamp.

Common commands

prism search "rate limit retry"
prism find-refs "User.save" --pretty
prism def "MyClass.handler"
prism prepare-edit "MyClass.handler"
prism module-map
prism --help

The --auto-overlay flag (default ON for editing-relevant subcommands) handles freshness for unpushed local edits — your dirty-file content flows into the query without a reindex.

Surfaces

Both surfaces talk to the same gateway and use the same token.

Contributing (developers)

git clone https://github.com/Fintama/swisper_prism
cd swisper_prism/apps/prism-cli
uv pip install -e .
uv run python -m pytest tests/ -v

See CHANGELOG.md for release history.