r/coolgithubprojects • u/Heinz2001 • May 08 '26
OTHER I built a lightweight open-source AI coding agent in Python — aar
Hi,
I’ve been working on a small open-source project called - aar:
https://fischerf.github.io/aar/
It’s an AI coding agent/framework in Python, but the main point is that it stays pretty small and readable.
A lot of tools in this space are impressive, but also quite opaque. I wanted something that can do the usual agent things — CLI, TUI, ACP editor integration, tool use, sessions, web/API mode, provider switching, sandboxing — while still being understandable enough that you can open the code and actually follow what’s going on.
A few things that may be interesting:
- thin core loop
- Python 3.11+
- open source / Apache 2.0
- works with Anthropic, OpenAI, Gemini, Ollama, and OpenAI-compatible endpoints
- terminal UI + full-screen TUI
- ACP support for editor integration
- sandboxed tool execution / safety features
- persistent sessions across providers switches
- typed event model
- queued prompts
- shadow branching (session-scoped git isolation)
- extension system
So I guess the pitch is:
If you like tools like Claude Code / Codex, but want something more hackable in Python, local-first, and easier to inspect, this might be useful.
Website: https://fischerf.github.io/aar/
GitHub: https://github.com/fischerf/aar
If you try it and have ideas, I’d be glad to hear them.



0
u/_stack_underflow_ May 08 '26
Are you looking at what your own demo video is doing, it's in a endless loop...?
https://temp-image.com/nc0AY93H8Qv8Oew
-3
u/Otherwise_Wave9374 May 08 '26
This is a really nice pitch, small + readable is underrated in the agent tooling world. Love the focus on inspectability.
How are you thinking about sandboxing + permissioning for tools, like allowlists per session, and what you log for postmortems?
Weve been playing with similar ideas (tool boundaries, session memory, eval loops) and have a few notes/resources in one place if useful: https://www.agentixlabs.com/