aicx

Operator front door for agent session logs.

aicx catalogs live Claude, Codex, Cursor, Grok, Gemini, Junie, Kimi, GitHub Copilot CLI, oh-my-pi / pi, Antigravity CLI, Vibecrafted, and operator-owned sources; renders readable whole-session extracts; and publishes a lexical-first search index. Sources remain content truth. The compact catalog owns session identity and topical project attribution.

There is no per-frame card mill and no aicx store command.

Install

Install the current published build. The commands below follow the @loctree/aicx dist-tag and the latest GitHub Release. Unreleased main stays on the contributor path.

npm install -g @loctree/aicx

The package name is @loctree/aicx. The unscoped name aicx on npm and on PyPI belongs to other projects.

On macOS and Linux, the same published build can be installed from the latest GitHub Release:

curl -fsSL https://raw.githubusercontent.com/Loctree/aicx/main/install.sh -o install.sh
AICX_INSTALL_MODE=release bash install.sh

That script is only the installer. It selects this machine's archive from the latest GitHub Release (AICX_RELEASE_TAG defaults to latest), verifies the adjacent SHA-256, and installs aicx and aicx-mcp into ~/.local/bin. Add ~/.local/bin to PATH when it is not already there. Set AICX_RELEASE_TAG=vX.Y.Z when you need one specific release.

Windows: use the npm command above, or take the x86_64-pc-windows-msvc zip from the latest release and run aicx.exe.

cargo install aicx follows crates.io. That registry is the library lane. The release workflow leaves it for a maintainer to publish with make publish-crates; a GitHub Release does not move it. See Releases.

Contributors, from a checkout:

cargo install --path . --locked --force --bin aicx --bin aicx-mcp

# Native GGUF embedder support:
cargo install --path . --locked --force --features native-embedder \
  --bin aicx --bin aicx-mcp

Channel order and shadow checks: install-paths.md.

Runtime model

1. Catalog — ~/.aicx/catalog/sessions.jsonl maps a session to project, agent, date, cwd, canonical source path, title, machine, and live source fingerprint.
2. Extract — aicx extract <agent> --session <id> --conversation renders a readable user/assistant transcript. Caching under ~/.aicx/extracts/ is optional.
3. Index — aicx index incrementally parses changed sources, removes tool/internal/system noise, and atomically publishes the global _all Tantivy generation.
4. Search — aicx search queries CURRENT with lexical ranking plus a recency prior. --deep explicitly adds dense mmap re-ranking.

aicx index                   # the one rebuild command: census + incremental parse + publish
aicx index status            # lexical_status + dense_status planes
aicx index --semantic        # opt-in dense on owner workstation
aicx catalog status          # power user: identity staleness without a write (see --help-full)
aicx search 'arrows vc-frame'
aicx search --deep '…'       # needs --semantic on this home
aicx search -p vetcoders/vibecrafted 'routing strzałek taby'

Multi-machine session sync, dense owner host, and HTTP serve: see docs/MULTI_MACHINE.md.

Project selection is metadata filtering over _all, not a requirement to build parallel project indexes.

Why this shape

• One catalog row replaces thousands of duplicated frame cards.
• Source fingerprints make indexing incremental for both new and changed sessions.
• Human-readable extracts stay whole-session and optional.
• Default search does not load an embedder or stream multi-gigabyte NDJSON.
• Missing indexes have a typed, bounded fallback; corrupt or stale indexes fail honestly.

Source coverage

First-class roots include:

• ~/.claude/projects
• ~/.codex/sessions
• ~/.cursor/projects/*/agent-transcripts/<uuid>/<uuid>.jsonl
• ~/.grok/sessions/*/chat_history.jsonl
• ~/.gemini/tmp/*/chats/session-*.json
• ~/.kimi-code/sessions/**/wire.jsonl
• ~/.copilot/session-state/<session-id>/events.jsonl (optional workspace.yaml)
• ~/.omp/agent/sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl and the same layout under ~/.pi/agent/sessions
• ~/.gemini/antigravity-cli/conversations/<cascade-uuid>.db and the same schema under ~/.gemini/antigravity/conversations
• Junie sources
• Vibecrafted control_plane/runtime_runs/*/transcript.log
• explicit operator markdown and Codescribe imports

Source opens go through a canonical allowlist resolver. Traversal, non-files, and symlink escapes are rejected.

GitHub Copilot CLI uses the canonical provider name copilot:

aicx extract copilot --session <session-id> --conversation
aicx extract all --provider copilot
aicx index
aicx search 'past decision' --agent copilot
aicx intents --agent copilot --emit json

See Copilot sessions for event coverage, source identity, direct-file extraction, and MCP usage.

oh-my-pi and upstream pi use the canonical provider name omp (pi and oh-my-pi are aliases):

aicx extract omp --session <session-id> --conversation
aicx extract all --provider omp
aicx search 'past decision' --agent omp
aicx search 'past decision' --agent pi
aicx intents --agent omp --emit json

See oh-my-pi sessions for the active branch, human speech versus harness injection, and both session stores.

Antigravity CLI uses the canonical provider name agy (antigravity and antigravity-cli are aliases). Legacy .pb exports and gemini-antigravity stay on Gemini:

aicx sessions list --agent agy
aicx extract agy --session <cascade-id> --conversation
aicx extract all --provider agy
aicx search 'past decision' --agent agy
aicx search 'past decision' --agent antigravity
aicx intents --agent agy --emit json

This is the beginning of the README. Read the rest at the original. Read the full README ↗