yrzhe/claude-skills/agentlog

agentlog · Multi-agent, multi-device activity pool + project context layer

agentlog has two layers:

• Layer 1 — event pool: captures notable activity from all your AI agents (Claude Code, Codex, Cursor, Maestri, browser-use) across all your machines (Macs + VPS) into one normalized event pool, synced via a private GitHub repo.
• Layer 2 — project context: distills the pool into a per-project AGENTS.md + CLAUDE.md + docs/agent-context/ snapshot, so any AI coding agent entering the project reads the same up-to-date state, decisions, and next steps.

Boundaries (when NOT to use)

Architecture

┌─────────────────────────────────────────────────────────────┐
│  Device A (Mac)              Device B (VPS)                  │
│  ─────────────────           ─────────────────              │
│  Claude Code                 Claude Code                     │
│  Codex                       Codex                           │
│  Maestri canvas              (scripts)                       │
│  browser-use                                                 │
│       ↓                            ↓                          │
│  agentlog adapters           agentlog adapters               │
│       ↓                            ↓                          │
│  ~/.agent-seeds/             ~/.agent-seeds/                 │
│  (local pool clone)          (local pool clone)              │
│       ↓                            ↓                          │
│        └──── GitHub (private repo) ────┘                     │
└─────────────────────────────────────────────────────────────┘

Each agent → adapter → local pool shard → GitHub. Other devices pull. Everyone sees a unified feed.

Setup

Detailed: references/setup.md. Quick version:

gh repo create agent-seeds --private --confirm
agentlog init --repo git@github.com:YOUR_USER/agent-seeds.git
agentlog poll --once --source claude_code   # smoke test

On each additional device: same agentlog init command. Pool syncs via GitHub.

Common flows

See what I did across all agents today

agentlog recap

Live feed of last 4 hours, all sources

agentlog pool --last 4h

Group view by project / agent / source

agentlog pool --by project
agentlog recap --by agent

Pull everything from other machines now

agentlog pull

Push current local changes immediately

agentlog push --force

Manually log an event from a script

agentlog event push '{"action":{"type":"checkpoint","status":"completed","label":"deploy success"},"summary":"shipped api v2"}'

Distill a project's recent activity into a context document (Layer 2)

agentlog context init --project-root .
agentlog brief --project agentlog --last 7d

Writes AGENTS.md + CLAUDE.md + docs/agent-context/{state,decisions,next-steps}.md so the next agent (Cursor / Codex / Claude Code) entering the project reads a unified state. Requires ANTHROPIC_API_KEY.

Re-sync entry-file blocks after manually editing state

agentlog context sync

Migrate historical seed data (one-time)

agentlog migrate-from-seed --dry-run
agentlog migrate-from-seed

Run the background daemon (auto poll + sync)

agentlog daemon install   # macOS launchd or Linux systemd
agentlog daemon start

Reference index

For schema details read src/agentlog/schema.py directly — the type hints + validate() are the source of truth.

When extending

• Adding a new source → implement SourceAdapter interface (src/agentlog/adapters/base.py), register in _ADAPTER_REGISTRY in src/agentlog/cli.py
• Changing event schema → bump SCHEMA_VERSION in src/agentlog/schema.py and write a converter
• Adding a CLI command → wire into build_parser() in src/agentlog/cli.py

Status

v0 — schema + pool + 5 adapters (claude_code, codex, cursor, maestri, browser_use) + GitHub sync + daemon + shot + recap + Layer 2 (brief + context). Tests: 59 passing.