GEOFFRUSSY

The AI Development Orchestrator.

Geoffrussy is a CLI-based development platform that interviews you about your project, designs the architecture, generates executable plans, and orchestrates code generation across multiple AI models. Written in Go, distributed as a single binary with zero external dependencies.

Built With

GoCobra CLIBubbletea TUISQLiteMCP ProtocolOpenAIAnthropicGLMOllama

INITIALIZATION SEQUENCE

# Install via Go toolchain
$ go install github.com/mojomast/geoffrussy@latest

# Or download a pre-built binary from GitHub Releases

$ geoffrussy init
 Config initialized at ~/.geoffrussy/config.yaml

$ geoffrussy interview

Core Capabilities

Interview-Driven Workflow

An interactive CLI mode where Geoffrey asks probing questions to understand your project scope, constraints, and goals. No prompt engineering required — just have a conversation.

Architecture First

Generates complete system architecture documents with tech stack choices, data models, and component diagrams before a single line of code is written.

Executable DevPlans

Breaks projects into atomic tasks organized in phases. Plans are exported as standard Markdown — portable, version-controllable, and readable by any agent.

Multi-Model Orchestration

Route planning to high-reasoning models (Claude, GPT) and execution to fast, cheap models (Llama, GLM, any Ollama-compatible model). Built-in cost tracking and rate limit monitoring.

Phase Reviews

Automated checkpoint reviews between phases to catch architectural drift, security issues, and alignment with the original design intent.

State & Context Management

SQLite-backed state persistence with checkpoint/rollback. Summarizes project context into a context.md that lives with your repo.

The Execution Cycle

STEP 01

Interview Mode

Geoffrey asks clarifying questions about your project using high-reasoning models. What are we building? What's the tech stack? What are the constraints? The interview adapts based on your answers.

STEP 02

Architectural Blueprint

A comprehensive architecture document is generated — tech stack, component structure, data models, API design. This becomes the source of truth for everything that follows.

STEP 03

DevPlan Generation

The project is broken down into phased DevPlans with 7-10 phases of 3-5 tasks each. Complex tasks get routed to stronger models; routine coding goes to fast, cheap ones.

STEP 04

Orchestrated Execution

Geoffrey orchestrates execution across configured models, tracking progress through each phase. Built-in cost tracking shows exactly what each step costs.

The Ussyverse Lineage

DevUssy Integration

DevUssy started as a standalone Python planning pipeline (and still works as one — it has 15 stars on GitHub). Its circular development methodology has been integrated into Geoffrussy as the core planning engine.

When Geoffrussy generates a plan, it uses the DevUssy Protocol — the adaptive interview, complexity analysis, and phased plan generation that DevUssy pioneered. DevUssy provides the thinking patterns; Geoffrussy handles the execution (file I/O, terminal commands, git operations).