explaingit

yeachan-heo/gajae-code

Analysis updated 2026-05-18

203TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

A command-line tool that wraps an AI coding agent in a four-step interview, plan, execute, verify workflow to keep AI-assisted coding on track.

Mindmap

mindmap
  root((Gajae-Code))
    What it does
      Structured AI coding workflow
      Four-step loop
      Reduces off-track agent work
    Workflow skills
      deep-interview
      ralplan
      team
      ultragoal
    Role agents
      Executor
      Architect
      Planner
      Critic
    Tech stack
      TypeScript
      Bun
      tmux

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run an AI coding agent through a structured interview, plan, execute, verify loop instead of freeform prompting

USE CASE 2

Coordinate multiple parallel coding sessions in separate tmux panes and git worktrees

USE CASE 3

Get a read-only architecture or plan review from a dedicated critic or architect agent before code changes start

What is it built with?

TypeScriptBunnpmtmux

How does it compare?

yeachan-heo/gajae-codedexhorthy/shannonplacenl2026/best-of-algorithmic-trading
Stars203204204
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderateeasy
Complexity3/53/51/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Early-stage beta project, recommended runtime is Bun, and tmux is needed for the parallel-session workflow.

MIT license: use, modify, and redistribute freely, including commercially, as long as you keep the copyright notice.

In plain English

Gajae-Code is a command-line tool that wraps an AI coding agent in a structured workflow, aimed at making AI-assisted programming more reliable and less prone to going off course. You install it as a package and run it from a terminal. It is early-stage and described as an experimental beta project. The core idea is a four-step loop: first, the agent asks clarifying questions before touching any code, then it builds and critiques a plan, then it runs the actual implementation, and finally it verifies the result against a stated goal. These four steps are packaged as named workflow skills called deep-interview, ralplan, team, and ultragoal. The intention is that the agent does not jump straight to writing code without understanding what you actually want. The tool also ships four role-based agents that specialize in different tasks: an executor for writing and refactoring code, an architect for read-only review of how the codebase is structured, a planner for sequencing work and defining acceptance criteria, and a critic for reviewing whether a plan is actionable before execution starts. For running multiple tasks in parallel, Gajae-Code can orchestrate sessions using tmux, a terminal multiplexer that lets you split a terminal into multiple panes running independently. It also supports git worktrees, which create an isolated copy of a repository so you can work on a branch without touching your main checkout. The project is published on the npm registry and runs on Bun as the recommended runtime. It is licensed under MIT and described by its author as a distillation of lessons from earlier agent harness projects they built for OpenAI and Anthropic APIs.

Copy-paste prompts

Prompt 1
Help me install Gajae-Code with Bun and run it in tmux mode for the first time
Prompt 2
Explain what the deep-interview, ralplan, team, and ultragoal skills each do in Gajae-Code's workflow
Prompt 3
Help me set up a git worktree so I can run Gajae-Code on a branch without touching my main checkout
Prompt 4
Show me how the executor, architect, planner, and critic agents differ in Gajae-Code

Frequently asked questions

What is gajae-code?

A command-line tool that wraps an AI coding agent in a four-step interview, plan, execute, verify workflow to keep AI-assisted coding on track.

What language is gajae-code written in?

Mainly TypeScript. The stack also includes TypeScript, Bun, npm.

What license does gajae-code use?

MIT license: use, modify, and redistribute freely, including commercially, as long as you keep the copyright notice.

How hard is gajae-code to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is gajae-code for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.