Metadata-Version: 2.4
Name: swisper-prism-cli
Version: 0.1.0
Summary: Prism — code-intelligence CLI for AI coding agents
Project-URL: Homepage, https://github.com/Fintama/swisper_prism
Project-URL: Repository, https://github.com/Fintama/swisper_prism
Project-URL: Documentation, https://github.com/Fintama/swisper_prism/tree/main/apps/prism-cli
Author: Fintama Prism Team
License: Proprietary - Fintama Internal Use Only
Requires-Python: >=3.11
Requires-Dist: click>=8.1
Requires-Dist: httpx>=0.27
Description-Content-Type: text/markdown

# 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

```bash
pip install --user swisper-prism-cli
```

Or with [pipx](https://pipx.pypa.io/) (recommended on systems where `pip --user` is restricted):

```bash
pipx install swisper-prism-cli
```

Requires Python ≥ 3.11.

## Auth

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

```bash
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

```bash
prism ping
```

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

## Common commands

```bash
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

| Tool | When |
|---|---|
| `prism` CLI (this package) | Coding agents — anything with shell access (Cursor, Claude Code, Windsurf, Codex, Devin, Antigravity) |
| MCP server (`prism-hosted` in `~/.claude.json`) | Non-editing agents (chatbots like Claude Desktop) |

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

## Contributing (developers)

```bash
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`](./CHANGELOG.md) for release history.
