GitHub - Protocol-Lattice/go-harness · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
Protocol-Lattice
go-harness
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>88 Commits<br>88 Commits
bin
bin
cmd
cmd
docs/superpowers
docs/superpowers
internal
internal
.gitignore
.gitignore
AGENTS.md
AGENTS.md
Makefile
Makefile
README.md
README.md
go.mod
go.mod
go.sum
go.sum
View all files
Repository files navigation
go-harness
Deterministic, local-first autonomous software engineering runtime.
Vision
go-harness combines deterministic orchestration with LLM reasoning.<br>Rather than a single autonomous agent, it executes a staged pipeline<br>backed by a shared workspace index.
Architecture
User<br>Coordinator<br>┌───────────────────┼───────────────────┐<br>▼ ▼ ▼<br>Planner Context Builder Validator<br>│ │ ▲<br>└───────────┬───────┴───────────┐ │<br>▼ │ │<br>Editor │ │<br>│ │ │<br>filesystem / git / shell tools │ │<br>▼ │ │<br>Repairer ───────────────┘───────┘
Workspace Index<br>┌──────────────────────────────────────────┐<br>│ Packages │ Files │ Symbols │ Graph │ AST │<br>└──────────────────────────────────────────┘
Pipeline
Planner creates a task graph.
Retriever queries the workspace index.
Context Builder assembles minimal grounded context.
Editor performs symbol-aware edits.
Validator runs formatting and tests.
Repairer fixes diagnostics until validation succeeds or retries are<br>exhausted.
Features
AST-based workspace index
Stale-safe persistent workspace index builds
Symbol-aware editing
Approval-gated tool execution
Queue-driven /think workflow
Swarm workers
Git worktrees
Workspace diff previews
Fast parallel validation
Deterministic retrieval
Self-healing validation loop
Usage
When installed, the go-harness binary stays under 10 MB instead of<br>carrying the full runtime directly. It delegates to the larger<br>go-harness-agent runtime binary. If go-harness-agent is available on<br>PATH, run:
GO_HARNESS_AGENT_BIN=go-harness-agent go-harness
Binary Size
go-harness uses a small launcher binary plus a larger agent runtime binary.<br>Release builds are size-optimized with:
go build -trimpath -ldflags "-s -w"
Current macOS install size:
Binary<br>Size
go-harness<br>1.8 MB
go-harness-agent<br>38 MB
go-harness-filesystem<br>2.4 MB
go-harness-git<br>2.2 MB
go-harness-shell<br>2.2 MB
The launcher stays very small because it delegates to go-harness-agent.<br>The agent contains the main autonomous coding runtime, including orchestration,<br>queueing, workspace handling, tool execution, and validation support.
License
See LICENSE.
About
No description, website, or topics provided.
Resources
Readme
Uh oh!
There was an error while loading. Please reload this page.
Activity
Custom properties
Stars
stars
Watchers
watching
Forks
fork
Report repository
Releases
v0.3.3
Latest
Jun 17, 2026
+ 3 releases
Packages
Uh oh!
There was an error while loading. Please reload this page.
Contributors
Uh oh!
There was an error while loading. Please reload this page.
Languages
Go<br>99.4%
Makefile<br>0.6%
You can’t perform that action at this time.