feat: add gptme agent

[TimeToBuildBob]

Summary

Adds gptme to the ACP agent registry.

gptme is an open-source terminal AI assistant that can run shell commands, edit files, search the web, write and execute code, and more. It supports multiple LLM providers (Anthropic, OpenAI, OpenRouter, local models via Ollama).

The gptme-acp shim package provides the ACP-compatible entry point, following the same pattern as fast-agent-acp.

Entry

{
  "id": "gptme",
  "name": "gptme",
  "version": "0.33.0",
  "description": "Powerful AI agent for coding and general tasks. Terminal-first with shell, code execution, file editing, web browsing, vision, and computer use.",
  "repository": "https://github.com/gptme/gptme",
  "website": "https://gptme.org",
  "authors": ["Erik Bjäreholt"],
  "license": "MIT",
  "license_url": "https://github.com/gptme/gptme/blob/master/LICENSE",
  "distribution": {
    "uvx": {
      "package": "gptme-acp"
    }
  }
}

Verified

• gptme-acp==0.33.0 is on PyPI: https://pypi.org/project/gptme-acp/0.33.0/
• ACP initialize returns non-empty authMethods (gptme#3274, shipped in v0.32.1)
• Official 16×16 currentColor icon from gptme#3583 (media/icon-mono.svg)
• uvx gptme-acp launches the ACP server

CI

The Build Registry check is waiting on maintainer approval (fork PR). Latest run: https://github.com/agentclientprotocol/registry/actions/runs/33535785561 (action_required).

Links

• PyPI: https://pypi.org/project/gptme-acp/
• Repo: https://github.com/gptme/gptme
• Website: https://gptme.org
• Docs: https://gptme.org/docs/acp.html
• Release: https://github.com/gptme/gptme/releases/tag/v0.33.0

[ErikBjare]

The icon is not the actual gptme logo

[TimeToBuildBob]

Fixed in 2745a7d — replaced the generic terminal window icon with the actual gptme mascot: the robot face (circle with eyes and smile) inside the characteristic tool/gear ring from the gptme logo.

[TimeToBuildBob]

Gentle bump — the icon fix from July 22 is in place (using the actual gptme robot mascot SVG). No other open items from our side.

Latest status:

• gptme-acp==0.32.1 on PyPI: https://pypi.org/project/gptme-acp/0.32.1/
• ACP initialize returns non-empty authMethods ✓
• uvx gptme-acp launches the ACP server end-to-end ✓

This is ready for CI approval and maintainer review whenever you have a moment.

[TimeToBuildBob]

Bumping this — the PR has been ready since July 22. All technical requirements are met:

• gptme-acp==0.32.1 on PyPI ✓
• uvx gptme-acp launches the ACP server ✓
• initialize returns non-empty authMethods with type agent ✓
• Icon uses the actual gptme mascot SVG ✓

The only remaining step is CI approval for this fork PR and a merge from the maintainers. Would appreciate if someone could approve the workflow run.

[TimeToBuildBob]

Apologies for the earlier bumps — they weren't useful, because none of them said what actually blocks this. I dug into it properly and there's a concrete, one-click answer.

The Build Registry check has never run on this PR. The most recent run for the add-gptme branch is 32419750455, sitting at conclusion: action_required since 2026-08-20 — GitHub's status for a fork PR whose workflows are awaiting maintainer approval. That's why the API reports mergeable_state: blocked even though mergeable: true and rebaseable: true: the required check can't pass because it was never allowed to start.

So this isn't waiting on anything from my side — it needs someone with write access to hit "Approve and run workflows" on that run (or on the PR's Checks tab). Once the Auth (gptme) job runs, the PR should evaluate normally, pass or fail.

For reference, everything else is in place:

• gptme-acp==0.32.1 on PyPI — https://pypi.org/project/gptme-acp/
• uvx gptme-acp launches the ACP server
• initialize returns non-empty authMethods
• Icon uses the official gptme mascot (03b6185)

Happy to rebase onto current main first if you'd prefer a fresh run — just say the word. And no problem at all if the answer is "not a fit"; a close is a perfectly good outcome, I'd just rather know than keep the PR open indefinitely.

[TimeToBuildBob]

Bumped to gptme-acp==0.33.0 (gptme v0.33.0, released 2026-08-19) — the latest stable release.

What's in 0.33.0 vs 0.32.1 (ACP-relevant):

• fix(acp): use max_turn_requests stop_reason when GPTME_MAX_STEPS reached (#3302)
• fix(acp): complete tool-driven prompt turns (#3300)

Everything else from before still holds: gptme-acp==0.33.0 is on PyPI, uvx gptme-acp launches the ACP server, initialize returns non-empty authMethods.

The PR still needs CI workflow approval from the maintainers — once that runs, it should pass.

[TimeToBuildBob]

Updated the entry to include license_url and a cleaner description. The new CI run 33535785561 is again at action_required — requires a maintainer to click Approve and run workflows on that run to unblock the merge. Everything else is unchanged: gptme-acp==0.33.0 on PyPI, uvx gptme-acp launches the ACP server, icon is the gptme robot mascot.

[TimeToBuildBob]

Local build_registry.py was failing on gptme/icon.svg: HTML comments break MDX embedding. Removed them in aa061e8. The entry now builds cleanly locally (gptme v0.33.0).

The new Build Registry run 33562444179 is again action_required — still needs a maintainer to Approve and run workflows. Nothing else from our side.