> **A project-level orchestrator for AI coding agents**
| [**Bubble Tea**](https://github.com/charmbracelet/bubbletea) | `charm.land/bubbletea/v2` | TUI framework (Elm architecture) |
|
| [**Lip Gloss**](https://github.com/charmbracelet/lipgloss) | `charm.land/lipgloss/v2` | Styling & layout |
|
| [**Bubbles**](https://github.com/charmbracelet/bubbles) | `charm.land/bubbles/v2` | Reusable TUI components |
|
| [**Log**](https://github.com/charmbracelet/log) | `github.com/charmbracelet/log` | Structured logging |
|
| [**x**](https://github.com/charmbracelet/x) | `github.com/charmbracelet/x` | `x/mosaic` for terminal image rendering |
Plus:
- `github.com/charmbracelet/log` for structured logging
- `github.com/fsnotify/fsnotify` for config watching
- `github.com/osteele/liquid` for prompt templating
- `github.com/stretchr/testify` for Go test assertions
## Releasing
CI and release workflows run automatically via GitHub Actions:
- **CI** (`.github/workflows/ci.yml`) — runs on every push and PR: lint, test, build
- **Release** (`.github/workflows/release.yml`) — triggered by pushing a version tag
To ship a new release:
```bash
git tag v0.4.1
git push origin v0.4.1
```
This builds cross-platform binaries (macOS/Linux, amd64/arm64) via [GoReleaser](https://goreleaser.com),
publishes a GitHub Release with grouped changelogs, and updates the
[Homebrew tap](https://github.com/junhoyeo/homebrew-contrabass).
After GoReleaser publishes the release, [`scripts/generate-release-notes.ts`](scripts/generate-release-notes.ts)
appends contributor attribution — each change is tagged with the author's `@username` and linked PR,
and first-time contributors get a dedicated shout-out section.
## Notes for contributors
For detailed contribution guidelines, see [CONTRIBUTING.md](CONTRIBUTING.md).
- The dashboard assets must exist before the Go binary is built because the binary embeds `packages/dashboard/dist`.
- `packages/landing` renders `README.md`, so README changes also affect the landing site.
- If workspace package resolution looks broken in `packages/dashboard` or `packages/landing`, rerun `bun install` at the repository root to refresh workspace links.
- TUI snapshots live in `testdata/snapshots/` and are exercised by `internal/tui` tests.