# AgentActa

> AgentActa is a local audit trail and search engine for AI agent sessions. It indexes JSONL session logs from OpenClaw, Claude Code, and Codex CLI into SQLite with FTS5 full-text search, and serves a dashboard UI. One command, zero config, everything stays on your machine.

Things to know about AgentActa:

- It parses JSONL session files, not API calls — it reads what your agents already write to disk
- Storage modes: `reference` (index only, source files stay on disk) or `archive` (full JSONL stored in SQLite)
- Default port is 4003, configurable via `PORT` env var
- Auto-detects session directories: `~/.openclaw/agents/*/sessions/`, `~/.claude/projects/*/`, `~/.codex/sessions/`
- No framework, no build step — vanilla Node.js HTTP server + vanilla JS frontend
- SQLite FTS5 for full-text search across messages, tool calls, and tool results
- Session health scoring detects retry loops, bail-outs, high error rates, vague prompts, and incomplete runs

## Docs

- [README](https://github.com/mirajchokshi/agentacta#readme): Quickstart, features, configuration, API reference, storage modes, environment variables
- [API endpoints](https://github.com/mirajchokshi/agentacta#api): REST API for sessions, search, timeline, files, export, health, insights, and maintenance
- [Context API](https://github.com/mirajchokshi/agentacta#context-api): Endpoints that give agents historical context about files, repos, and other agents before they start working
- [Configuration](https://github.com/mirajchokshi/agentacta#configuration): Config file locations, storage modes, session paths, environment variable overrides

## Code

- [GitHub repository](https://github.com/mirajchokshi/agentacta): Source code, issues, releases
- [npm package](https://www.npmjs.com/package/agentacta): Install via `npx agentacta` or `npm install -g agentacta`
- [CHANGELOG](https://github.com/mirajchokshi/agentacta/blob/main/CHANGELOG.md): Release history

## Optional

- [Homepage](https://agentacta.com/): Marketing site with feature overview and install command
- [CONTRIBUTING](https://github.com/mirajchokshi/agentacta/blob/main/CONTRIBUTING.md): Contribution guidelines