qqcode

qqcode is an open-source coding agent developed by qnguyen3 designed to automate development workflows across both terminal and editor environments. It provides agentic code generation, refactoring, and tool execution capabilities powered by a modular skill and tool management system. In daily use, qqcode operates through an interactive interface with integrations across terminal workflows and editor extensions, including support for VS Code and Zed. It utilizes an internal ToolManager and SkillManager to dynamically register capabilities, execute commands, inspect files, and apply modifications with explicit tool approval safeguards. What sets qqcode apart is its extensible modular skill architecture (such as built-in PDF processing and customizable skill directories in .qqcode/skills) combined with multi-environment distribution across editor interfaces and CLI environments. It allows developers to customize available toolsets per project while maintaining approval controls for safe code execution. qqcode is an open-source tool distributed via GitHub with no direct licensing fees, relying on user-provided API access or local model backends for operation.

Tags: ai agent, cli, coding agent, developer tools, terminal

Visit qqcode

Key features

  • Modular skill architecture — Dynamically injects and manages specialized project skills stored under .qqcode/skills/. - Tool approval workflow — Enforces user verification and UI approvals before critical tool or command execution. - Multi-editor distribution — Provides dedicated extensions and distribution configurations for editors including VS Code and Zed alongside CLI operation. - Extensible ToolManager — Allows programmatic registration, reloading, and injection of developer tools. - Contextual session reloading — Preserves and updates agent state with initial conversation histories and active skill profiles.

Use cases

Use Case: Interactive Code Refactoring in Editors Developers can invoke qqcode inside editors like VS Code or Zed to analyze existing codebases, generate multi-file diffs, and inspect tool approvals directly through an integrated UI panel.

Use Case: Custom Skill Execution and Document Analysis Teams can define custom domain skills under .qqcode/skills/ (such as PDF documentation parsing or proprietary API tooling) and enable the agent to utilize these capabilities dynamically during coding tasks.

Use Case: Terminal-Based Automated Patching Developers can run qqcode via the command line to parse error logs, locate relevant source files, execute test suites, and iteratively generate patches under human-in-the-loop approval.

Who it is for

qqcode is built for software engineers who want an extensible, multi-interface AI coding agent that works seamlessly across the CLI and modern editors like VS Code and Zed. It is less suited for developers seeking an enterprise SaaS platform with fully managed compute and no-setup GUI hosting.

Install guide

Installation Install the repository tools locally or build the extension components directly from source: bash # Clone the repository git clone https://github.com/qnguyen3/qqcode.git cd qqcode # Install dependencies and local package (standard Python/Node setup) pip install -e .

First Run Configure your API credentials and ensure local project skills are recognized: bash # Export your preferred model provider API key export OPENAI_API_KEY="your-api-key" # or export ANTHROPIC_API_KEY="your-api-key" # Initialize qqcode in your current repository qqcode --help

Example Session Launch an agent session to inspect a codebase and execute tool-assisted refactoring: bash qqcode "Scan the vibe directory, add type annotations to ToolManager, and run pytest"

Part of CLI Coding Agents

Categories: AI Coding Agents, Code Assistants, Developer Tools

Related CLI agents

  • Warp — Warp is an AI-integrated terminal emulator and CLI workspace built by warpdotdev. Engineered in Rust with native GPU rendering, Warp…
  • Amazon Q Developer CLI — Amazon Q Developer CLI is an open-source command-line coding assistant developed by Amazon Web Services (AWS). Built primarily in Rust,…
  • CLAII — CLAII is an open-source terminal-based AI coding assistant developed by agencyswarm. Built in Python, it serves as a lightweight CLI…
  • Even — Even is an agent-native desktop workspace and orchestration environment developed by Todience, Inc. It integrates a native terminal, an embedded…
  • Repomon — Repomon is an open-source developer harness and repository companion tool created by Ali Hamza Azam. Built with a Rust core…
  • Construct — Construct is an open-source terminal-based orchestrator and multi-harness manager developed by the construct-worlds organization. It functions as a meta-tool and…
  • AI Tools
  • Categories
  • Industries
  • CLI Coding Agents
  • MCP Servers
  • MCP Categories