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
On first launch, micro·cc creates ~/.micro-cc/ with an example .env — add your API keys there and restart. That directory is also where conversation history and project state live.
Platform
Built and tested on macOS. Works on Linux. Windows should work via pip install + any modern terminal — iTerm2 is macOS-only but micro·cc doesn't depend on it, it just looks best there.
Environment
Edit ~/.micro-cc/.env — set one endpoint:
# Option 1: Anthropic direct + OpenAI for embeddings
ANTHROPIC_API_KEY=sk-ant-
OPENAI_API_KEY=sk-proj-
# Option 2: LiteLLM proxy (Bedrock, Azure, etc.)
# LITELLM_BASE_URL=https://your-proxy.com
# LITELLM_API_KEY=sk-...
# Web search (always needed for search tools)
SERPAPI_KEY=
Usage
microcc /path/to/your/project
Controls:
Enter— submit promptShift+Enter— newlineEscape— interrupt/clear— reset conversation/model— switch model/exit— quit
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.
Architecture
start_live_.py (CLI) textual TUI
│
│ async for event in claude_loop()
▼
claude_loop_.py (Core) API calls, tool execution, JSONL storage
│
│ execute_tool_call()
▼
tools/ bash_, file ops, browser, computer_use
│
▼
~/.micro-cc/projects/{hash}/ conversation persistence
Full system access plus verbose planning. The model reads your codebase, writes plans, executes tools, observes results, iterates — until the work is done.
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.36.tar.gz.
File metadata
- Download URL: micro_cc-0.2.36.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 |
00a3306d0012d8401a4a0cd187b5291c8ab4692573f9375a6b1782f84c7bdad0
|
|
| MD5 |
27f4e56b1e2fca015bf9ca436e7f8b42
|
|
| BLAKE2b-256 |
4e7acb4feaa4d2e9cf1c7a4c67535d23f9cb4447bbccad6d16720d498beb45a7
|
File details
Details for the file micro_cc-0.2.36-py3-none-any.whl.
File metadata
- Download URL: micro_cc-0.2.36-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 |
e1a0a4e767aab745bded010fb9ecf996bfcff723949cad5af5bb502cfd8a80ac
|
|
| MD5 |
ca3c6abddda189cf7ced941c65a49691
|
|
| BLAKE2b-256 |
0766b23e4aa449dfb627378499fd861b0788c13460761e31ce192ad3c9e73a4f
|
