Aider sessions, visible from the Mac notch

Aider sessions and opt-in usage, without changing Aider.

Download for macOSFree 3-day trial · Apple silicon
AgentPeek monitoring an active Aider terminal session from the Mac notch

01

Active aider processes, labeled by workspace

Aider installs from the Python package aider-chat and runs as aider. AgentPeek recognizes active interactive processes, uses their real working directory for project labeling, and opens the terminal that owns the run. Help, version, config display, model-list, update, upgrade, and shell-completion commands stay out of session discovery.

02

The latest run from Aider's rolling Markdown history

By default, Aider appends chat to the git root's .aider.chat.history.md. AgentPeek follows AIDER_CHAT_HISTORY_FILE and chat-history-file from AIDER_CONFIG or Aider's normal home, git-root, and current-directory config search. It reads the latest # aider chat started at ... section, user lines prefixed with ####, and assistant Markdown. Aider's rolling file has no durable session ID or exact per-message timestamps, so AgentPeek does not invent either.

03

Aggregate usage only when you already enabled the log

Aider can write JSONL with --analytics-log. If that path is already set by AIDER_ANALYTICS_LOG or config, AgentPeek sums exact message_send prompt, completion, total-token, per-message cost, model, and event-time fields into calendar-month and daily views. The log carries no cwd or session ID, so those numbers remain explicitly aggregate and are never attached to one chat. Its total_cost is cumulative inside a process and is not summed again. AgentPeek never creates the file or silently enables analytics.

04

Terminal-owned prompts, with no transport claims

Aider exposes no managed hook, native ACP session transport, or first-party MCP surface for AgentPeek to attach. A selected Aider session therefore has no Direct Chat, cancellation, or in-notch permission answers. Prompts and approvals stay in Aider's terminal; AgentPeek offers Open Terminal as the honest handoff.

05

Read-only Quick Routes

Quick Routes opens Aider's home config at ~/.aider.conf.yml and state directory at ~/.aider. Project chat and input histories stay project-scoped; AgentPeek resolves the active chat history from the process workspace instead of pretending it is a global file.

Questions

Yes. AgentPeek detects active aider terminal processes, labels them from their working directory, and shows the latest recorded user and assistant chat from Aider's rolling project Markdown history.
No. Aider exposes no supported managed hook or AgentPeek plugin contract. Monitoring uses read-only terminal process discovery and Aider files that already exist; AgentPeek changes no Aider configuration.
No. Aider does not expose an attachable selected-session transport. Direct Chat, cancellation, and permission answers stay off; Open Terminal returns you to the Aider process that owns the prompt.
Only from an existing --analytics-log JSONL path. Exact message_send prompt, completion, total-token, per-message cost, model, and time fields become aggregate month and daily totals. The log has no project or session attribution, and AgentPeek never enables it.
Aider appends many process runs to one project-level .aider.chat.history.md file. Each run has a start heading but no durable session ID or exact per-message timestamps, so AgentPeek shows the latest recorded section instead of fabricating separate addressable sessions.

Keep your agents in view

Download for macOSFree 3-day trial · Apple silicon