Qode – The first AI agent that can generate 50k line codebases in one prompt
Qode is a terminal-based autonomous coding agent for long-running tasks and massive codebase development. It features a rich TUI, multiple LLM provider support, and an intelligent pipeline for coordinating multi-file changes from one-line fixes to cross-cutting transformations spanning hundreds of files. Its Modus Maximus mode aims to generate 50k-80k lines of code in a single shot through a four-phase pipeline with specialist agent profiles. Other capabilities include intent classification, dynamic escalation, four-tier memory, verification pipeline, self-correction, plugin and skill systems, and MCP client support.
Notifications You must be signed in to change notification settings
Fork 0
Star 1
BranchesTags
Open more actions menu
Folders and files
NameName
Last commit message
Last commit date
Latest commit
History
25 Commits
25 Commits
.github/workflows
.github/workflows
apps/q-cli
apps/q-cli
npm
npm
packages
packages
scripts
scripts
.gitignore
.gitignore
.npmrc
.npmrc
Q.md
Q.md
README.md
README.md
bands.sh
bands.sh
install.sh
install.sh
package.json
package.json
pnpm-lock.yaml
pnpm-lock.yaml
pnpm-workspace.yaml
pnpm-workspace.yaml
tsconfig.json
tsconfig.json
vitest.config.ts
vitest.config.ts
Repository files navigation
Node SDK v0.1.0
MIT
Qode is a terminal-based autonomous coding agent for long-running tasks and massive codebase development. It operates directly in your terminal with a rich TUI, connects to multiple LLM providers, and orchestrates multi-file changes through an intelligent pipeline that scales from one-line fixes to cross-cutting transformations spanning hundreds of files.
The Node SDK is a thin client that reuses the same Qode CLI configuration, tools, skills, and MCP servers. It streams responses in real time, surfaces approvals and tool calls, and lets you orchestrate sessions programmatically.
Overview
Qode provides an autonomous agent runtime, enabling you to:
Build custom applications — Integrate Qode into your own tools and workflows
Automate complex tasks — Script multi-turn conversations across long-running sessions
Run massive codebase operations — Use Modus Maximus for cross-cutting changes
Core capabilities
Two execution modes: AUTO (single-agent turn loop with classifier-driven behavior) and MODUS MAXIMUS (4-phase pipeline: plan generation, user confirmation, sequential sub-agent execution through specialist profiles, and final summary)
Intent classification: Heuristic analysis of every prompt for scope, depth, file references, action verbs, parallelism needs, and verification requirements
Dynamic escalation: Runtime mode escalation via DynamicReclassifier when the current execution strategy is insufficient
Modus Maximus: 15-50 dependency-aware plan steps, user confirmation (Looks Good / Needs Revision / Redo), sequential sub-agent execution with heuristic profile resolution, and final summary (Aims to generate 50k-80k lines of code for a fresh project in one shot through our specialized architecture)
Specialist agent profiles: Editius (surgical code editing via StrReplace), Rewritius (full-file rewrites and refactoring), Searchius (codebase analysis), Auto (task-adaptive); switchable via /agent
Four-tier memory: WorkingMemory with priority-tagged compaction, EpisodicRecall with TF-IDF scoring, LTPM (disk-backed persistence with retention policies), SemanticRecall (vector-based ANN search via HNSW index), CodebaseGraph (language-aware model for TS, JS, Python, Rust, Go, Java)
Verification pipeline: 7 gates (syntax, lint, typecheck, unit tests, integration tests, architecture, full suite) with per-language auto-detection and SHA-256 caching
Self-correction: Automated fix-and-reverify loop with architecture escalation
Multiple LLM providers: Anthropic, OpenAI, Google Gemini, Ollama (local, no API key), Kimi, OpenAI-compatible
Plugin system: Manifest-based discovery with lifecycle hooks
Skill system: Reusable prompt templates and inline scripts
MCP client: stdio and HTTP/SSE transport
Session persistence: JSONL wire format, blob store, migration system
Non-interactive mode: --prompt for CI/CD, --output-format json
Onboarding wizard: First-run setup for provider and model
Available Packages
Package Description Status
apps/q-cli Main CLI — orchestrator, TUI, memory, MCP, plugins, verification Available
packages/agent-core Core agent runtime — context, turn loop, tools, sub-agents, profiles Available
packages/qprovs LLM provider abstraction Available
packages/qmain Execution environment — file ops, shell, git, web Available
packages/node-sdk Programmatic Node.js SDK Available
packages/oauth OAuth 2.0 for MCP server auth Available
packages/telemetry Optional crash reporting and telemetry Available
Quick Start
Installation
npm install -g qode-agent
Requires Node.js >= 22.19.0 and pnpm >= 10.33.0. The installer builds the project, creates ~/.Q/, and installs the q-cli wrapper.
Usage
Interactive mode (opens TUI)
q-cli
Shorthand
q
One-shot prompt for CI/CD
q-cli -p "Add error handling to src/routes/users.ts"
Use Modus Maximus for complex tasks
q-cli q> /mode modus-maximus q> Refactor the authentication system to use OAuth 2.0
Resume a previous session
q-cli -S
Non-interactive with JSON output
q-cli -p "Fix the type errors" --output-format json
CLI Options
-S, --session Resume a session -C, --continue Continue last session -y, --yolo Auto-approve all actions -m, --model Override LLM model -p, --prompt Non-interactive mode --plan Plan mode on startup --auto Auto permission mode --setup Re-run setup wizard --output-format text | json | stream-json --skills-dir Additional skill directories --cwd Working directory --tui / --no-tui Force/enable TUI
Commands
init Initialize a Qode project session Manage sessions (list, show, delete, export, import) config View and edit configuration doctor Diagnose and fix configuration issues migrate Migrate data between versions update Check for and install updates completions Generate shell completion scripts daemon Start/stop the Qode daemon connect Connect to a remote instance profile Manage agent profiles plugin Manage plugins
Slash Commands
/help Interactive help dashboard /status Session status dashboard /session Show/manage session info /clear Clear transcript /exit Gracefully exit /version Show version info /mode Switch mode (auto, modus-maximus) /agent Switch profile (auto, editius, rewritius, searchius) /qmd Generate Q.md with project conventions
Environment Variables
Q_PROVIDER LLM provider (anthropic, openai, ollama, etc.) Q_MODEL Model name (e.g. claude-sonnet-4-20250514) Q_API_KEY API key for the provider Q_BASE_URL Custom base URL Q_THINKING Thinking level (none, low, medium, high)
Configuration
Loaded in ascending priority: built-in defaults → ~/.Q/config.toml → .q/config.toml (walked up from cwd) → environment variables. First run launches interactive onboarding wizard.
License
MIT
About
No description, website, or topics provided.
Resources
Readme
Uh oh!
There was an error while loading. Please reload this page.
Activity
Stars
1 star
Watchers
0 watching
Forks
0 forks
Report repository
Releases
1 tags
Packages 0
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
TypeScript 98.8%
Other 1.2%