micro · cc — cognitive compute
88
""
88,dPYba,,adPYba, 88 ,adPPYba, 8b,dPPYba, ,adPPYba, ,adPPYba, ,adPPYba,
88P' "88" "8a 88 a8" "" 88P' "Y8 a8" "8a a8" "" a8" ""
88 88 88 88 8b 88 8b d8 · 8b 8b
88 88 88 88 "8a, ,aa 88 "8a, ,a8" "8a, ,aa "8a, ,aa
88 88 88 88 `"Ybbd8"' 88 `"YbbdP"' `"Ybbd8"' `"Ybbd8"'
Knowledge work is, by extension, a coding problem.
Frontier models with full system access — shell, filesystem, browser, MCP. Verbose, thorough planning paired with unrestricted file operations lets micro·cc take on complex multi-step work autonomously. Point it at any project directory and go.
Install
pip install micro-cc
Cross-platform — macOS, Linux, Windows — with terminal keybindings (Shift+Enter, word-jump, etc.) detected and configured automatically on first run, whatever terminal you're in.
Usage
microcc /path/to/your/project
First run, type /login and pick Anthropic, a LiteLLM proxy (Bedrock, Azure, etc.), or Ollama — it writes ~/.micro-cc/.env for you, no manual editing needed.
Controls:
Enter— submit ·Shift+Enter— newline ·Escape— interrupt/login— configure endpoint ·/model— switch model ·/clear— reset conversation ·/keys— store project-scoped secrets ·/exit— quit- Type
/to see the full command list (setup, skills, MCP, headless, etc.)
Headless (batch / cron)
microcc-headless /path/to/base_dir tasks.json
Each task gets its own subfolder under base_dir — base_dir/{task.name}/ — which is a real project_dir with its own scoped messages.jsonl. Runs are fully autonomous (no approval gate), so a batch never blocks waiting on stdin. To pick a task back up in the full interactive TUI:
cd base_dir/{task.name} && microcc .
Manifest format (tasks.json):
{
"tasks": [
{
"name": "fix-auth-bug",
"prompt": "Fix the JWT expiry bug — tokens aren't refreshing correctly.",
"files": ["/absolute/path/to/src/auth.py", "/absolute/path/to/src/middleware.py"]
},
{
"name": "add-tests",
"prompt": "Add unit tests for the pagination helper."
}
]
}
files is optional and must use absolute paths — cron jobs have no reliable cwd.
Tasks run sequentially. Each is instructed to end its final reply with STATUS: DONE|NEEDS_INPUT|FAILED — <summary>, which the runner parses into a tree view at the end:
/path/to/base_dir
├── ✓ fix-auth-bug DONE Patched JWT expiry check in auth.py
├── ? add-tests NEEDS_INPUT Which test framework does this repo use?
└── ✓ cleanup-logs DONE Removed dead logging branches
2/3 done · 1 need input · 0 failed
cd into: /path/to/base_dir/add-tests (then `microcc .` to continue)
Only tasks that failed or need input get a cd hint — no need to open every subfolder to check on a large batch.
Data
~/.micro-cc/
.env API keys
projects/
{project}_{hash}/
messages.jsonl conversation history
summary.json sliding-window summary
project_path.txt maps hash back to directory
Tools
| Tool | Description |
|---|---|
bash_ |
Shell execution in project_dir |
read_ |
Read files with line numbers, offset/limit |
write_ |
Create/overwrite files, auto-creates dirs |
edit_ |
Surgical string replacement (fails if ambiguous) |
glob_ |
Find files by pattern, sorted by mtime |
grep_ |
Regex search with context lines |
browser_ |
Web browsing and page extraction (beta) |
computer_use_ |
Screen interaction and GUI automation (beta) |
All tools are discoverable — use search_tools to find more at runtime.
Relative paths resolve to project_dir. Absolute paths work anywhere.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file micro_cc-0.2.38.tar.gz.
File metadata
- Download URL: micro_cc-0.2.38.tar.gz
- Upload date:
- Size: 2.8 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.13.11
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
245d67202ee4e296513d77355a713e1a832175161ad0bb03442e6d9fb83df097
|
|
| MD5 |
3765bf3f3543a7b78450750681297227
|
|
| BLAKE2b-256 |
14f2a9f26505366a579a01bef9ab800c626578ea73f213f046459de144413d64
|
File details
Details for the file micro_cc-0.2.38-py3-none-any.whl.
File metadata
- Download URL: micro_cc-0.2.38-py3-none-any.whl
- Upload date:
- Size: 2.8 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.13.11
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9b172527a0526770efff84ed6370ca7a8046c7b55dfaa074b1a866e34dc8020c
|
|
| MD5 |
3da5671e8647a5c7d6e71ea7ada48597
|
|
| BLAKE2b-256 |
b474742779581019e07a58cb43a5e1206bf2aeb976f5e727f35750ba7bbc2113
|
