Disclaimer: Gajae-Code is an experimental, beta-stage early project. Expect rough edges and verify outputs before relying on it for important work.

Gajae-Code

A red-claw coding-agent harness for crisp interviews, resilient plans, tmux-native execution, and durable verification.

Story

I created an earlier OpenAI code harness and an earlier Anthropic-code harness. After living with those harnesses, I felt the same thing kept happening: the harness got bloated, but the work still collapsed into one useful loop.

Usage

Gajae-Code is published through the normal npm registry. Install it with Bun for the recommended runtime workflow:

bun install gajae-code

For repository development, use the source checkout commands in Development.

Start the recommended tmux-backed experience:

gjc --tmux

Bare gjc launches directly without creating or attaching a tmux session:

gjc

Run inside an isolated Git worktree when you want a safer branch-local workspace:

gjc --tmux --worktree <path>

Use a dedicated path for throwaway or branch-specific work so the main checkout stays clean.

Default TUI identity

The default dark TUI identity is the GJC red-claw theme: a red/orange crustacean look for Gajae-Code terminals. Explicit user theme settings still win.

Why Gajae-Code?

Gajae-Code (gjc) keeps the public agent surface intentionally small while making the runtime around it dependable. It focuses on one useful loop:

deep interview -> ralplan -> team execution -> ultragoal verification

The result is a compact CLI that stays easy to reason about, but still gives you session state, worktree isolation, tmux orchestration, model routing, tool execution, and persistent evidence when the work needs it.

Workflow surface

Gajae-Code ships four default workflow skills:

Skill	What it does
deep-interview	Removes ambiguity before planning or code changes.
ralplan	Builds and critiques a plan before mutation.
team	Coordinates tmux-backed parallel execution.
ultragoal	Tracks durable goals, checkpoints, and verification evidence.

And four bundled role agents:

Agent	What it does
executor	Bounded implementation, fixes, and refactors.
architect	Read-only architecture and code-review assessment.
planner	Read-only sequencing and acceptance criteria.
critic	Read-only plan critique and actionability review.

No sprawling default skill zoo: the harness improves by making this small method better.

Development

Install dependencies and local defaults:

bun install
bun run install:defaults

Run the CLI from source:

bun packages/coding-agent/src/cli.ts --help

Default workflow definitions live in source, not committed .gjc copies:

packages/coding-agent/src/defaults/gjc/skills/<name>/SKILL.md
packages/coding-agent/src/prompts/agents/<role>.md

For workflow-definition or rebrand-surface changes, run the project gates:

bun scripts/check-visible-definitions.ts
bun scripts/verify-g002-gates.ts
bun scripts/rebrand-inventory.ts --strict
bun test packages/coding-agent/test/default-gjc-definitions.test.ts

For a package-by-package map, see docs/codebase-overview.md.

Inspirations and lineage

Gajae-Code builds on lessons from a small family of agent harnesses while keeping the public GJC surface intentionally focused. Historical attribution is kept in NOTICE.md.

License

MIT. See LICENSE.