ScarletMercy

ScarletMercy / chcode

Public

Terminal-based AI coding agent — 5000+ lines, 13 tools, session persistence, git-aware workflow. Built with LangChain + Typer + Rich.

17
0
100% credibility
Found Apr 19, 2026 at 17 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

Terminal-based AI coding agent that enables natural language interaction for file editing, git management, web search, and task automation with human approval options.

How It Works

1
🔍 Discover ChCode

You hear about ChCode, a friendly terminal helper that chats with you to write and fix code like a smart coding buddy.

2
📥 Get it set up

You grab the tool with a simple download command, and it settles right into your computer without any fuss.

3
🚀 First hello

You type one word to start, and it welcomes you with a fun logo and asks simple questions to get ready.

4
🧠 Link your AI thinker

It spots your ready AI connections or guides you to add one quickly, so your buddy can start thinking smart thoughts.

5
💬 Chat your coding wish

You type what you want like 'build a simple game' or 'fix this bug', and watch it plan and work step by step.

6
Choose your speed
✅
Careful review

See previews of file changes and say yes or no before anything happens.

🚀
Speedy auto

Let it handle everything fast without pausing for approvals.

🎉 Code magic done

Your files are updated, git saves the changes safely, and you have working code ready to run and share.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 17 to 17 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is chcode?

Chcode is a terminal-based AI coding agent built in Python using LangChain, Typer, and Rich—over 5000 lines delivering 13 tools for file ops, shell execution, web search, and sub-agents. It runs a persistent chat REPL in your terminal, handling git-aware workflows like branching from messages and auto-rollback on edits. Solves fragmented coding sessions by keeping AI assistance, history, and project state in one git-tracked spot.

Why is it gaining traction?

As one of the best terminal-based coding agents, it skips web-based terminals on GitHub for a local, session-persistent experience with SQLite checkpoints and real-time context tracking. Git integration shines—fork sessions into branches, toggle YOLO mode for auto-approvals or Common for diff previews. Extensible skills system and OpenAI-compatible models make it a lightweight alternative to heavier agents.

Who should use this?

Backend devs prototyping CLI tools or C code in terminals, ops folks automating git workflows, or full-stack hackers needing a terminal-based AI coding assistant for quick iterations. Suited for solo projects where persistence and bash/git tools speed up terminal-based coding without IDE overhead.

Verdict

Promising early-stage tool (17 stars, 1.0% credibility) with strong README docs but no visible tests—install via uv tool for a low-risk trial. Grab it if terminal-based AI coding agents fit your flow; maturity lags but core git-aware persistence delivers immediate value.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.