MiniCode v0.1.1
MiniCode v0.1.1 is the first interview-ready MVP release of a controlled local CLI coding agent.
Capabilities
- Routes natural-language tasks into project analysis, error analysis, small-feature planning, and patch suggestions.
- Reads real project context through
list_files,read_file, andsearch_code. - Separates MiniCode's
app_rootfrom the analyzedworkspace. - Builds compressed, structured prompts from tool results.
- Supports deterministic Mock mode and an OpenAI-compatible
/chat/completionsAPI. - Formats every result with task type, execution trace, analysis, risk check, and memory status.
Demo
cd examples/sample_project
python ../../main.py "帮我分析这个项目"
python ../../main.py "帮我给用户模块增加修改昵称接口"
python ../../main.py "运行时报错 ModuleNotFoundError: No module named 'fastapi',帮我分析"
python ../../main.py "读取 .env 看看"Safety boundary
- Read-only MVP: no shell execution, automatic edits, test execution, or Git operations.
read_fileandsearch_codeboth pass throughPermissionChecker.- Denies workspace escapes, sensitive directories, private keys, environment files, and credential-like filenames.
- Real-model failures degrade to Mock output without breaking the execution trace.
Engineering evidence
- 47 automated tests at the v0.1.1 release tag.
- GitHub Actions on Python 3.10, 3.11, and 3.12.
- Terminal-style security demo in
docs/demo.svg. - Zero third-party runtime dependencies.
The current main branch additionally includes verified output examples for all
four skills, a standalone architecture diagram, and the archived v0.1.1 product
specification.
Known limitations
- Keyword-based routing and code search rather than semantic analysis.
- Current directory is treated as the workspace root.
- Task memory is stored as local JSON and is not recalled.
- Mock output demonstrates execution structure, not model quality.