Hacking on shellboto — prerequisites, build, test, lint, CI, release flow.
| File | What it covers |
|---|---|
| prerequisites.md | Go 1.26+, make, required tooling |
| build-from-source.md | make build, make test, all targets |
| hooks.md | Lefthook stages + local loop |
| linting.md | golangci-lint v2 config explained |
| commit-messages.md | Conventional Commits rules + scope list |
| testing.md | Real SQLite, real pty, no-mocks rule |
| ci.md | GitHub Actions workflows walkthrough |
| releasing.md | release-please flow + emergency manual |
| github-settings.md | Pointer to .github/SETTINGS.md |
git clone https://github.com/amiwrpremium/shellboto.git
cd shellboto
./scripts/install-dev-tools.sh # lefthook, golangci-lint, etc.
make hooks-install # wire lefthook into .git/hooks
make test # go test ./...
make lint # golangci-lintCommit messages follow
Conventional Commits —
the commit-msg hook enforces the format.
See CONTRIBUTING.md in the repo root. Short version: open an issue first for non-trivial changes, run the hooks, send a PR.
- prerequisites.md — what to install first.
- build-from-source.md — get the binary.