Metadata-Version: 2.5
Name: heirmos-cli
Version: 0.1.0
Summary: Heirmos memory for coding agents — session-start briefing and automatic capture for Claude Code, Codex and Cursor
Project-URL: Homepage, https://heirmos.com
Project-URL: Guide, https://dashboard.heirmos.com/guide
Project-URL: Plugin, https://github.com/team-pneumora/pneumora-plugins/tree/main/heirmos
Author: Pneumora
License: MIT
Keywords: agents,claude-code,codex,heirmos,mcp,memory
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development
Requires-Python: >=3.11
Requires-Dist: httpx>=0.27
Description-Content-Type: text/markdown

# heirmos-cli

Your memory, in every coding-agent session — automatically.

`heirmos` is the small client that [Heirmos](https://heirmos.com) agent
integrations call from their lifecycle hooks:

- `heirmos briefing` — at session start, prints a compact index of your recent
  memories for this repository plus older memories that touch the current
  context. The harness injects it as context.
- `heirmos capture` — before compaction / at session end, sends the
  human-readable part of the conversation (your prompts and the agent's prose —
  never tool output, file contents or thinking), redacted for credentials, so
  Heirmos can keep only durable decisions, preferences and facts.
- `heirmos whoami` — which account your key belongs to.

One memory is shared across Claude Code, Codex, Cursor, Claude.ai and ChatGPT:
a decision made in Claude Code is there when Codex opens the repo tomorrow.

It never blocks a session: no key, no network or an unreadable transcript means
one line on stderr and exit code 0.

## Install

```bash
uv tool install heirmos-cli      # or: pipx install heirmos-cli
export HEIRMOS_API_KEY="hk_..."  # dashboard.heirmos.com → /account → API 키
heirmos whoami
```

Then wire it into your agent:

- **Claude Code** — `/plugin marketplace add team-pneumora/pneumora-plugins`,
  then `/plugin install heirmos@pneumora-plugins`
- **Codex / Cursor** — see <https://dashboard.heirmos.com/guide>

## Environment

| Variable | Default | Purpose |
|---|---|---|
| `HEIRMOS_API_KEY` | — | required; missing ⇒ commands do nothing |
| `HEIRMOS_API_BASE` | `https://api.heirmos.com` | self-hosted: your API URL |
| `HEIRMOS_SOURCE` | `claude-code` | client label (`codex`, `cursor`, …) |
| `HEIRMOS_STATE_DIR` | `~/.heirmos/state` | capture offsets + `capture.log` |

Requires Python 3.11+. Depends only on `httpx`.
