aical

A local-only weekly calendar for coding-agent sessions. It reads the local histories written by Codex, Claude Code, Cursor, pi, OpenCode, Gemini, AmpCode, OpenClaw, and Copilot directly—without ccusage or another usage-collector dependency.

Run with npx

Requires macOS and Node.js 22.13 or newer.

npx aical

The command starts a background server on a free loopback port and opens the calendar in your default browser. The server shuts itself down after all Calendar tabs are closed. It reads session history from your home directory; for locally logged sessions created by newer AmpCode versions, it uses your signed-in amp CLI to read the corresponding export. No session content is uploaded.

To choose a port or keep the server attached to the terminal without opening a browser:

npx aical --port 8787
npx aical --no-open

By default, activity intervals separated by 15 minutes or less are shown in the same calendar block. Set AICAL_IDLE_GAP to a non-negative number of minutes to change that threshold:

AICAL_IDLE_GAP=20 npx aical

Invalid values fall back to 15 minutes. A gap equal to the threshold remains in the same block; a longer gap starts a new block.

Session costs use totals recorded by the agent when available and local model-price estimates otherwise. Sources such as Cursor and Copilot that do not record usage locally are marked unavailable and excluded from known cost and token totals. A session can appear as multiple calendar blocks when it contains longer idle gaps. Each block spans one or more prompt-to-completed-response intervals, while its active time excludes idle gaps between those intervals. Costs and token usage remain session-level. Sources without response-completion timestamps are clearly marked as approximate.

Develop locally

npm install
npm run dev

The development collector listens only on 127.0.0.1:8787; the web development server proxies /api requests to it. Use npm test to run the typecheck, production build, and test suite.