https://github.com/flyingrobots/hubless
Git-native, auditable project flow. Issues, Kanban, and execution in your repo. No hub; just Git.
https://github.com/flyingrobots/hubless
ci-cd cli crdt developer-experience devtools event-sourcing git issue-tracker kanban tasks tui workflow
Last synced: about 2 months ago
JSON representation
Git-native, auditable project flow. Issues, Kanban, and execution in your repo. No hub; just Git.
- Host: GitHub
- URL: https://github.com/flyingrobots/hubless
- Owner: flyingrobots
- License: mit
- Created: 2025-09-18T23:07:52.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-09-20T13:51:11.000Z (9 months ago)
- Last Synced: 2025-09-20T14:40:35.320Z (9 months ago)
- Topics: ci-cd, cli, crdt, developer-experience, devtools, event-sourcing, git, issue-tracker, kanban, tasks, tui, workflow
- Language: Go
- Homepage:
- Size: 199 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Hubless
Hubless is a terminal-native, Git-backed work tracker. It treats issues, pull requests, and boards as append-only event streams under `refs/hubless/**`, then presents them through a Charmbracelet-powered TUI and CLI. This repository houses the specs, tooling, and implementation that turn Git repositories into fully auditable planning systems.
## Getting Started
> **Status:** Early development. Specs are in place; implementation is in progress.
### Prerequisites
- Go 1.22+
- Git 2.30+
- Optional: [gh](https://github.com/cli/cli) for GitHub integration experiments
### Clone
```bash
git clone https://github.com/flyingrobots/hubless.git
cd hubless
```
### Build the utilities
The Go module is initialized but the primary CLI is still under construction. A helper binary for progress updates exists today:
```bash
go build ./cmd/update-progress
```
### Run the progress updater
The legacy Python script has been replaced with the Go implementation (spec documented in `docs/reference/update-progress-algorithm.md`). Point the tool at your `git-mind` checkout once the Go port is finished.
```bash
./update-progress --root ../git-mind
```
## Project Docs
- `docs/PRD.md` – Product requirements and roadmap.
- `docs/TechSpec.md` – Architecture, data model, sync contracts.
- `docs/design/tui.md` – Bubbletea TUI views, interactions, styling.
- `docs/reference/implementation-skeleton.md` – Hexagonal layout and scaffolding.
- `docs/reference/update-progress-algorithm.md` – Transcription of the ledger updater logic.
- `AGENTS.md` – Workflow rules, coding standards, collaboration notes.
- `@hubless/` – Structured planning data (tasks, stories, features, milestones schemas).
## Development Principles
- Git is the source of truth; no central server required.
- Conflict-free, append-only event streams for issues, boards, and PRs.
- Hexagonal architecture with Go application services, Git adapters, and Charmbracelet UI layers.
- CLI command surface will use Charmbracelet Fang/Cobra to keep styling consistent with the TUI.
## Contributing
See `CONTRIBUTING.md` for task workflow, branching rules, and code quality expectations.
## License
This project is licensed under the MIT License – see `LICENSE` for details.