OpenPlus

A pure-Go, terminal-native coding agent.
Anthropic and OpenAI-compatible models · persistent memory · LSP code intelligence · MCP tools.

Alpha. v0.0.1-alpha is the first tagged build. The architecture is settled and the test suite is green, but interfaces may still move and it has seen little real-world mileage. See Status for what is proven and what is not.

Install

curl -fsSL https://raw.githubusercontent.com/7-solutions/openplus/main/scripts/install.sh | sh

Works on Linux, macOS, and WSL2 (amd64 and arm64). The script detects your platform, verifies the SHA-256 checksum, and installs to ~/.local/bin (or /usr/local/bin when writable).

# Pin a version
OPENPLUS_VERSION=v0.0.1-alpha curl -fsSL https://raw.githubusercontent.com/7-solutions/openplus/main/scripts/install.sh | sh

# Choose the directory
OPENPLUS_INSTALL=$HOME/bin curl -fsSL https://raw.githubusercontent.com/7-solutions/openplus/main/scripts/install.sh | sh

# With Go
go install github.com/7-solutions/openplus/cmd/openplus@latest

# From source
git clone https://github.com/7-solutions/openplus && cd openplus
CGO_ENABLED=0 go build -o openplus ./cmd/openplus

Quickstart

# No API key needed — the scripted fake provider proves the wiring
openplus --fake -p "say hello"

# With a real model
export ANTHROPIC_API_KEY=sk-ant-...
openplus -p "explain the error handling in internal/agent/loop.go"

# Interactive TUI
openplus

Configure

OpenPlus reads opencode.json from your project root — the same surface OpenCode uses — plus AGENTS.md for project instructions.

{
  "model": "anthropic/claude-sonnet-5",
  "instructions": ["AGENTS.md"],

  "provider": {
    "anthropic": { "options": { "apiKey": "{env:ANTHROPIC_API_KEY}" } },
    "local": {
      "options": { "baseURL": "http://localhost:11434/v1", "apiKey": "ollama" },
      "models": { "qwen2.5-coder": { "name": "Qwen2.5 Coder" } }
    }
  },

  "permission": { "bash": "ask", "write": "ask" },

  // Code intelligence — opt-in, you supply the server binary
  "lsp": {
    "enabled": true,
    "servers": { ".go": { "command": "gopls" } }
  }
}

Full reference: docs/configuration.md.

What it does

LSP in one minute

go install golang.org/x/tools/gopls@latest

{ "lsp": { "enabled": true, "servers": { ".go": { "command": "gopls" } } } }

Now the agent sees compiler errors in files it edits, without being asked, and can call lsp_hover, lsp_definition, lsp_symbols, and lsp_references directly. Servers start lazily on first use; a missing binary is a warning, never a crash.

Commands

/help lists everything. Highlights:

Full list: docs/commands.md.

Status

Alpha. Honest accounting of where this stands:

Proven

• 27 packages, go test ./... green, -race clean
• CGO_ENABLED=0 build gate enforced in CI
• Architecture guarded by regression tests, not convention — six of them, including two that fail the build if a wire type crosses a port boundary
• LSP verified end to end against a real gopls

Not yet proven

• Little real-world mileage. Interfaces may move before v0.1.0.
• The binary links glibc dynamically, despite CGO_ENABLED=0: the Turso driver reaches libturso through purego, which needs the dynamic loader. It is portable across mainstream glibc distributions but will not run on stock Alpine/musl. The "single static binary" goal is not currently met.
• macOS and arm64 builds are cross-compiled and CI-tested, but have had no manual soak testing.

Not built (deliberately deferred, each needs its own decision record): voice input, MCP marketplace, web/share UI, hosted multi-tenant mode, LSP server auto-install.

Architecture

Ports and adapters, enforced rather than encouraged. The core depends on eleven port interfaces in internal/ports/; every external system is an adapter behind one.

internal/ports/        the eleven seams + neutral types (no wire type may cross)
  providerfake/        scripted provider for tests
internal/provider/     adapter-only: anthropic · openaicompat · select · sse
internal/lsp/          LSP adapter: client · manager · wire  (only place LSP is known)
internal/memory/       Turso vector + modernc FTS5 shadow, RRF fusion
internal/agent/        the turn loop
internal/runtime/      composition root: ports → adapters
internal/tui/          Bubble Tea front-end

Two hard rules carry regression tests that fail the build when violated:

• Core depends on ports, not adapters — internal/ports/leak_guard_test.go
• No wire type crosses a seam — internal/ports/lsp_leak_guard_test.go

Decisions live in docs/adr/; specs and change history in openspec/. Start with AGENTS.md — it is the single source of truth for how this project is built.

Contributing

The build gate is mandatory and spec-first: an approved OpenSpec change (openspec/changes/<id>/) exists before any code, tests are written red first, and every architectural rule ships with the test that enforces it. Read AGENTS.md before starting.

go build ./... && CGO_ENABLED=0 go build ./...
go test ./... && go test -race ./internal/...
go vet ./...

Documentation

• Installation — every method, upgrade, uninstall, troubleshooting
• Configuration — full opencode.json reference
• Commands — every slash command
• Feature matrix — OpenPlus vs OpenCode vs MiMoCode
• ADRs — why the architecture is what it is

License

Apache License 2.0 — Copyright 2026 7 Solutions.