Understands your codebase
Works with your existing project instead of treating every prompt like an isolated conversation. Grace reads files, maps structure, and acts in context.
Your coding agent.
A terminal AI coding agent that works inside your local codebase — it reads your files, understands your project, finds problems, and explains what needs to be fixed.
grace · v0.1.0 — working in ~/projects/grace
Grace is working…
→ read_file vercel.json
→ search_files "outputDirectory"
• Found 2 issues in vercel.json
1. "buildCommand" is empty — no build step defined
2. no root route — the site returns 404 at /
→ Grace ✓ — 2 issues found, explained
Capabilities
Understands your project, not just your prompt.
Grace doesn't merely generate code. It inspects an existing project, understands the files, identifies problems, and explains what needs to be fixed — then writes the fix and verifies it.
Works in your terminal
A Python CLI and a full-screen Textual TUI built for developers who actually live in their terminal. No dashboard, no browser tab.
Built for real projects
Analyze files, identify problems, reason about code, run commands, and iterate until the task is done — with a clear report of exactly what changed.
Open source
MIT licensed, free to use, and open for community contributions. Grace is developed in the open — the code, the roadmap, and the docs.
Open source
Open source. Built in public.
Grace is MIT licensed and developed in the open. The repository ships with a contribution guide, a code of conduct, and a security policy — everything you need to get involved.
Install
Up and running in seconds.
Install from the repository, then launch GRACE in any project folder. No API key required to start.
# from the repository root
pip install .# in any project folder
grace
Optional — add a GROQ_API_KEY to .env or
~/.zeesh/env for fully local inference, or run
grace register and grace login to use the
hosted backend. See the
README
for details.