@hawkeye-xb.com/imprint-cli
v0.2.6
Published
Imprint CLI — long-term memory for AI coding tools (Claude Code, Cursor, Codex). Installs the imprint MCP server into your tool's settings file via a browser OAuth flow.
Maintainers
Readme
@hawkeye-xb.com/imprint-cli
Installer for Imprint — a long-term memory layer for AI coding tools (Claude Code, Cursor, Codex). Runs an OAuth flow in your browser, then writes the imprint MCP server entry into the target tool's settings file.
Quick install
Tell your AI agent (or run yourself):
npx --yes @hawkeye-xb.com/imprint-cli installDefaults to Claude Code (~/.claude/settings.json). For Cursor or Codex:
npx --yes @hawkeye-xb.com/imprint-cli install --tool cursor
npx --yes @hawkeye-xb.com/imprint-cli install --tool codexA browser opens to authorize via Logto. The CLI captures the issued Personal API Token, writes the MCP server entry without disturbing your other settings, and exits. Restart the AI tool to pick up the new server.
Commands
| | |
|---|---|
| imprint | Alias for imprint login. |
| imprint login | OAuth via browser; saves token to ~/.imprint/credentials.json (mode 0600). |
| imprint install [--tool <id>] | Log in (if needed) and write MCP config. Tools: claude-code (default), cursor, codex. |
| imprint logout | Forget the saved token. |
| imprint whoami | Print where the credentials are stored. |
What it writes
| Tool | File | Format |
|---|---|---|
| claude-code | ~/.claude/settings.json | JSON; merges mcpServers.imprint without touching other entries |
| cursor | ~/.cursor/mcp.json | Same JSON merge |
| codex | ~/.codex/config.toml | TOML block bracketed by # === imprint:begin / end === markers, idempotent on re-install |
Environment overrides
| Variable | Purpose |
|---|---|
| IMPRINT_DASHBOARD_URL | Override the dashboard origin (default: https://imprint.hawkeye-xb.com). |
| IMPRINT_API_BASE | Override the worker API base URL. Defaults to whatever the dashboard's /.well-known/imprint.json reports. |
License
Elastic License 2.0 (ELv2). See repo root.
