charmbracelet/bubbletea

At a glance

Rank

#302 of 401

#36 of 40 Go repos

Checks passed

7 of 17

Full list below

Best set up for

Aider

Score 62.0

Needs most work for

OpenHands

Biggest fix: Reproducible dev env (+10.0 pts)

What to fix first

Showing fixes for Claude Code

1. 1
   AGENTS.md / CLAUDE.md

   Add an AGENTS.md covering project goals, layout, setup commands, and conventions. Aim for 800+ chars of real guidance (not boilerplate).
   +13.2 pts
2. 2
   Reproducible dev env

   Add a Makefile or devcontainer or Dockerfile so the agent can set up the project in one command.
   +11.8 pts
3. 3
   CONTRIBUTING guide

   Add CONTRIBUTING.md describing branch naming, commit style, test commands, and the PR process.
   +5.3 pts

Score for each AI agent

Each agent weighs the checks by its own docs. Under each score are its top three. How each agent is scored →

Does charmbracelet/bubbletea have agent instructions?

An AGENTS.md (or CLAUDE.md) at the root tells AI coding agents how to build, test and work in the repo. A few agents also read a file of their own.

AGENTS.md / CLAUDE.md

✗None at the root (no AGENTS.md, CLAUDE.md, AGENT.md, .claude/CLAUDE.md or .claude/AGENTS.md)

Agent-specific files

None: no GEMINI.md, .cursor/rules, .openhands/setup.sh, .aider.conf.yml or .agents/skills

Repos that have one

23 of 40 Go repos · 221 of 401 repos on the leaderboard · See examples →

# AGENTS.md

Guidance for AI coding agents working in charmbracelet/bubbletea. A powerful little TUI framework 🏗. Written mainly in Go.

## Where things are

- Dependencies are declared in `go.mod`.
- Test files are spread through the tree, e.g. `commands_test.go`.
- Lint and format rules are configured in `.golangci.yml`.
- CI is defined in `.github/workflows`; read it for the exact install, lint and test steps.

## Commands

<!-- Fill in the exact commands CI runs. -->
- Install: TODO
- Test: TODO
- Lint: TODO

How charmbracelet/bubbletea compares

vs leaderboard average

7.6 pts below

Average 66.8

vs Go average

11.8 pts below

Average 71.0

Stars among Go repos

#19 of 40

One fix for the most agents: AGENTS.md / CLAUDE.md would raise the score for all 9 agents, by up to 13.3 points.

Similar repos

Same language and host as this repo, closest in overall score.

• go-gorm/gorm62.5
  Go · 40k ★
• go-chi/chi61.8
  Go · 23k ★
• cockroachdb/cockroach60.1
  Go · 32.6k ★
• hashicorp/terraform59.6
  Go · 50.1k ★
• dagger/dagger59.3
  Go · 16.6k ★
• microsoft/TypeScript57.5
  Go · 111.7k ★

Same topics, any language

Repos tagged with the same GitHub topics, most shared first.

• Textualize/textual75.6
  Python · CLI, framework, tui
• hsnice16/tula75.3
  TypeScript · CLI, tui
• ReactiveX/RxSwift72.5
  Swift · functional
• Textualize/rich80.1
  Python · tui
• nrwl/nx86.3
  TypeScript · CLI
• cli/cli84.5
  Go · CLI