agentlore

module
v0.2.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Mar 6, 2026 License: MIT

README

Agentlore

Open a PR, see the AI conversation that produced it. Agentlore turns your team's agent conversations into a shared, searchable resource linked to your code.

What It Does

A background daemon syncs conversations from local AI coding agents (via agentsview) to shared ClickHouse storage. A web UI lets the team browse, search, and navigate from git commits/PRs to the conversations that produced them.

  • Auto-sync — daemon watches local sessions and syncs to shared storage. Nothing changes in your workflow.
  • Secret masking — credentials and keys are redacted before data leaves the developer's machine.
  • Full-text search — search across all team conversations with filtered results and context snippets.
  • Git linking — commits and PRs link back to originating conversations via tool call detection.
  • Works with your agents — Claude Code, Cursor, GitHub Copilot, Gemini CLI, Codex, Amp, VSCode Copilot, OpenCode via agentsview.

Architecture

Developer's machine                     Shared infrastructure
┌─────────────────┐                    ┌──────────────────┐
│ Claude Code /    │                   │                  │
│ Cursor / etc.    │                   │   ClickHouse     │
│       ↓          │                   │   (conversations,│
│  agentsview      │  ──── daemon ───→ │    search, git   │
│ (local sessions) │   (secret mask    │    links)        │
│                  │    + sync)        │       ↓          │
└─────────────────┘                    │   Web UI         │
                                       │   (browse,       │
                                       │    search, link) │
                                       └──────────────────┘

Quick Start

# Start ClickHouse
docker compose up -d clickhouse

# Sync local conversations
agentlore sync

# Browse conversations
agentlore serve
# Open http://localhost:8080

Development

# Prerequisites: Go 1.25+, Node 22+, Docker

# Backend
go test ./internal/...

# Frontend
cd frontend && npm install && npm run dev

# Full build (frontend + Go binary)
make build

License

MIT

Directories

Path Synopsis
cmd
agentlore command
ABOUTME: CLI entry point with subcommands for sync daemon and API server.
ABOUTME: CLI entry point with subcommands for sync daemon and API server.
internal
api
ABOUTME: API handlers for team analytics endpoints (usage, heatmap, tool distribution).
ABOUTME: API handlers for team analytics endpoints (usage, heatmap, tool distribution).
config
ABOUTME: Configuration loading, user identity detection, and project identity resolution.
ABOUTME: Configuration loading, user identity detection, and project identity resolution.
gitlinks
ABOUTME: Extracts git commit SHAs and PR URLs from Bash tool call results.
ABOUTME: Extracts git commit SHAs and PR URLs from Bash tool call results.
reader
ABOUTME: Read-only access to agentsview SQLite data for the sync pipeline.
ABOUTME: Read-only access to agentsview SQLite data for the sync pipeline.
secrets
ABOUTME: Secret detection and masking pipeline stage for sync pipeline.
ABOUTME: Secret detection and masking pipeline stage for sync pipeline.
store
ABOUTME: ClickHouse connection management, schema bootstrap, and lifecycle.
ABOUTME: ClickHouse connection management, schema bootstrap, and lifecycle.
sync
ABOUTME: Daemon process orchestrating fsnotify watcher, periodic reconciler, and single-writer sync loop.
ABOUTME: Daemon process orchestrating fsnotify watcher, periodic reconciler, and single-writer sync loop.
web
ABOUTME: Embeds the compiled frontend dist directory into the Go binary.
ABOUTME: Embeds the compiled frontend dist directory into the Go binary.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL