selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

agentlogs logo

Self-host agentlogs

server-v0.1.4

Team observability for AI coding agent sessions

BetaSource AvailableOther
Updated10 hours ago
LanguageTypescript
Setup difficultyModerate
Stars
212
Port
3000 (HTTP server)
Requires
GitHub OAuth App, SQLite
Docker
ghcr.io/agentlogs/agentlogs
Install with Docker
AgentLogs session detail view showing transcriptTeam dashboard with activity metrics and agent usageGit integration view linking sessions to commitsSession browser list view

What is agentlogs?

AgentLogs is a self-hostable platform that gives teams visibility into AI coding agent sessions. It captures transcripts from several popular agents, automatically linking them to git commits so teams can see which session produced which code. The web dashboard shows activity metrics, agent and model usage, and per-member breakdowns. Sessions can be shared with the team for learning effective prompts and workflows. All transcripts are scanned for secrets (1,600+ patterns) and redacted locally before upload. It runs as a Docker container or standalone binary using SQLite for storage and BetterAuth for GitHub/GitLab OAuth authentication. The project is licensed under FSL-1.1-Apache-2.0 (source-available, converting to Apache-2.0 after two years).

Should you self-host agentlogs?

agentlogs scores 42/100 on selfhost.directory (how scoring works) and ranks #122 of 166 in Developer Tools. It has 212 GitHub stars.

It shipped 13 stable releases in the past year. The latest, server-v0.1.4, came out on 10 September 2026. New versions land roughly every 1 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Other-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is openhands (87/100, 92 094 stars). It scores higher overall, so compare the two before you pick. See agentlogs vs openhands side by side.

Features

  • AI coding agent transcript capture
  • AI-generated transcript summaries
  • CLI Tool
  • Git commit linking
  • GitHub OAuth authentication
  • GitLab OAuth/OIDC authentication
  • Multi-agent plugin support
  • Secret redaction
  • Session Sharing
  • Team dashboard
  • Visibility Controls

agentlogs README

How to install agentlogs

Install agentlogs with Docker

Docker
Environment variables
GITHUB_CLIENT_ID, GITHUB_CLIENT_SECRET, BETTER_AUTH_SECRET, WEB_URL, optional: OPENROUTER_API_KEY, AI_BASE_URL, AI_MODEL, AI_API_KEY, GITLAB_CLIENT_ID, GITLAB_CLIENT_SECRET, GITLAB_ISSUER, RESEND_API_KEY, EMAIL_SENDER, WAITLIST_ENABLED

docker run -d
--name agentlogs
-p 3000:3000
-v agentlogs-data:/app/.data
-e GITHUB_CLIENT_ID=...
-e GITHUB_CLIENT_SECRET=...
-e BETTER_AUTH_SECRET=...
-e WEB_URL=https://logs.example.com
ghcr.io/agentlogs/agentlogs:latest

Requires GitHub OAuth App and BETTER_AUTH_SECRET

How to configure agentlogs

  • AI_API_KEY
  • AI_BASE_URLFor OpenAI-compatible summary backends (preferred when AI_BASE_URL and AI_MODEL are set) Examples: Ollama, vLLM, LiteLLM

    For OpenAI-compatible summary backends (preferred when AI_BASE_URL and AI_MODEL are set) Examples: Ollama, vLLM, LiteLLM

  • AI_MODEL
  • BETTER_AUTH_SECRETBetterAuth secret for session encryption Generate with: openssl rand -base64 32 For local dev and CI e2e tests this value is fixed to match packages/e2e/utils/sign-cookie.ts. Override this in production.

    BetterAuth secret for session encryption Generate with: openssl rand -base64 32 For local dev and CI e2e tests this value is fixed to match packages/e2e/utils/sign-cookie.ts. Override this in production.

  • DB_LOCAL_PATH.data/db.sqliteOptional overrides

    Optional overrides

  • EMAIL_SENDER
  • GITHUB_CLIENT_IDGitHub OAuth Application credentials Create at: https://github.com/settings/developers

    GitHub OAuth Application credentials Create at: https://github.com/settings/developers

  • GITHUB_CLIENT_SECRET
  • GITLAB_CLIENT_IDGitLab OAuth Application credentials Create at: https://gitlab.com/-/user_settings/applications

    GitLab OAuth Application credentials Create at: https://gitlab.com/-/user_settings/applications

  • GITLAB_CLIENT_SECRET
  • GITLAB_ISSUERhttps://gitlab.com
  • OPENROUTER_API_KEYFor automatic summaries

    For automatic summaries

  • RESEND_API_KEYFor transactional emails

    For transactional emails

  • STORAGE_DIR.data/storage
  • WAITLIST_ENABLEDtrueWaitlist (set to "false" to auto-approve all signups as users)

    Waitlist (set to "false" to auto-approve all signups as users)

  • WEB_URLhttp://localhost:3000

agentlogs releases & version history

FAQ

How does AgentLogs compare to git-ai or agent-trace?

Tools like git-ai and agent-trace focus on tracking AI attribution at the code level (which lines were AI-generated). AgentLogs focuses on the session and prompt level, capturing full context of how code was created. They are seen as complementary with plans to integrate.

Which coding agents are supported?

AgentLogs supports Claude Code, Codex CLI, OpenCode, Pi, and Cline. Each has its own lightweight plugin, with more agents being added actively.

Who can see my transcripts?

You control visibility per transcript: Private (only you), Team (you and team members), or Public (anyone with the link). Defaults: public repos are public, private repos are team-visible, sessions without a repo are private.

How does AgentLogs protect my secrets and sensitive data?

AgentLogs automatically scans all transcripts for secrets before uploading using 1,600+ detection patterns covering API keys, tokens, passwords, and database credentials. Detected secrets are redacted entirely on your machine and never leave in plain text.

How does AgentLogs capture my sessions?

AgentLogs uses lightweight plugins for each coding agent. Install a plugin with a single command and it captures transcripts at the end of each session, automatically linking them to git commits.

Is AgentLogs source-available?

Yes, the entire codebase (CLI, web app, plugins) is on GitHub under FSL-1.1-Apache-2.0 and can be self-hosted with the official Docker image or standalone binaries.

More in AI

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…