micro · cc — cognitive compute

  ███╗   ███╗██╗ ██████╗██████╗  ██████╗
  ████╗ ████║██║██╔════╝██╔══██╗██╔═══██╗
  ██╔████╔██║██║██║     ██████╔╝██║   ██║
  ██║╚██╔╝██║██║██║     ██╔══██╗██║   ██║
  ██║ ╚═╝ ██║██║╚██████╗██║  ██║╚██████╔╝
  ╚═╝     ╚═╝╚═╝ ╚═════╝╚═╝  ╚═╝ ╚═════╝
       c o g n i t i v e  c o m p u t e

Knowledge work is, by extension, a coding problem.

Frontier models with full system access — shell, filesystem, browser, MCP — running directly on the metal. Verbose, thorough planning paired with unrestricted file operations means micro·cc can take on complex multi-step work autonomously. Point it at any project directory and go.

Install

Please use iTerm2. Highly recommended terminal UI.

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.

Recommended terminal: iTerm2 (macOS).

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 prompt
  • Shift+Enter — newline
  • Escape — 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.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.2.64)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for georgesalapa from gravatar.com georgesalapa

Credits

Author: George Salapa

License expression

MIT
View SPDX License List

Requires

Python >=3.12

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

micro_cc-0.2.30.tar.gz (2.8 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

micro_cc-0.2.30-py3-none-any.whl (2.8 MB view details)

Uploaded Python 3

File details

Details for the file micro_cc-0.2.30.tar.gz.

File metadata

  • Download URL: micro_cc-0.2.30.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

Hashes for micro_cc-0.2.30.tar.gz
Algorithm Hash digest
SHA256 2b985add49fd97658586bb038619cc51de0e5389790d2117bedad09466dc4a77
MD5 c9d84e08d480377ddd9a5158a48c0c56
BLAKE2b-256 996c30f7d9930d07f18b11c0c5475401285ed285c6617d9a47bbc08cafc0f7d1

See more details on using hashes here.

File details

Details for the file micro_cc-0.2.30-py3-none-any.whl.

File metadata

  • Download URL: micro_cc-0.2.30-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

Hashes for micro_cc-0.2.30-py3-none-any.whl
Algorithm Hash digest
SHA256 9eff45d0bd31919b3e8681e6645fe853143297944dd764054613e6fcd64f617c
MD5 f1ce481603ab1a2ee02ec6ba17417f23
BLAKE2b-256 6b540839e6d7fa3b6be80d3f8b6564c6728e84301751ecd28615b2f0df0b2078

See more details on using hashes here.

Release history Release notifications | RSS feed

0.2.64

2 files

0.2.63

2 files

0.2.62

2 files

0.2.61

2 files

0.2.60

2 files

0.2.59

2 files

0.2.58

2 files

0.2.57

2 files

0.2.56

2 files

0.2.55

2 files

0.2.54

2 files

0.2.53

2 files

0.2.52

2 files

0.2.51

2 files

0.2.50

2 files

0.2.49

2 files

0.2.48

2 files

0.2.47

2 files

0.2.46

2 files

0.2.45

2 files

0.2.44

2 files

0.2.43

2 files

0.2.42

1 file

0.2.41

2 files

0.2.40

2 files

0.2.39

2 files

0.2.38

2 files

0.2.36

2 files

0.2.35

2 files

0.2.34

2 files

0.2.32

2 files

0.2.31

2 files

This release

0.2.30 This release

2 files

0.2.29

2 files

0.2.28

2 files

0.2.27

2 files

0.2.26

2 files

0.2.25

2 files

0.2.24

2 files

0.2.23

2 files

0.2.22

2 files

0.2.21

2 files

0.2.20

2 files

0.2.19

2 files

0.2.18

2 files

0.2.17

2 files

0.2.16

2 files

0.2.15

2 files

0.2.14

2 files

0.2.13

2 files

0.2.11

2 files

0.2.10

2 files

0.2.9

2 files

0.2.8

2 files

0.2.7

2 files

0.2.6

2 files

0.2.5

2 files

0.2.4

2 files

0.2.3

2 files

0.2.2

2 files

0.2.1

2 files

0.2.0

2 files

0.1.12

2 files

0.1.11

2 files

0.1.10

2 files

0.1.9

2 files

0.1.8

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page