All‑night thinking git‑agent – drop it into any project, give it a topic, and let it think while you sleep.

• What is Murmur‑Agent?
• Features
• Installation
• Commands
• How it Works
  • How it Thinks
• Use Cases
• C CLI Version
• Comparison: TypeScript vs C
• Contributing
• License

Murmur‑Agent is a budget‑agnostic, local‑first, git‑native assistant that spends the night (or any amount of time) generating ideas, research notes, and technical insights around a topic you give it. Every thought becomes a Git commit, every insight a file—so your knowledge is always version‑controlled.

• Drop‑in: Works with any existing repo; no special scaffolding required.
• Budget‑agnostic: Operates with as few as 10 API calls/day or as many as 10 000.
• Local‑first: Can run completely offline on local hardware—no API key needed.
• Git‑native: Each thought is a commit; each insight is a file in murmur-output/.
• Dual implementation: TypeScript (Node.js) and a tiny C CLI (murmur-cli.c).
• Emoji branding: 🫧 bubbles rising to the surface of your codebase.

npm install murmur-agent
npx murmur think --topic "distributed systems patterns"

# Compile the C binary (POSIX systems, Raspberry Pi, Jetson, etc.)
gcc -o murmur c/murmur-cli.c -lm

# Run the same command without Node.js
./murmur think "distributed systems patterns"

The C binary stores its state under ~/.murmur/.

All commands create or update files under murmur-output/ and automatically commit them.

1. Provide a topic & budget – e.g., npx murmur think --topic "micro‑service observability".
2. Murmur‑Agent runs four thinking strategies (see below) to generate a knowledge tensor that grows with each iteration.
3. Each generated thought is written to a markdown file in murmur-output/ and committed to the repo.
4. When the session ends (or the budget is exhausted), you can murmur export to collect everything into a single document.

Murmur‑Agent cycles through four complementary strategies:

The cycle repeats until the budget is spent or the user stops the session.

• Research exploration overnight – Let Murmur‑Agent skim papers, generate hypotheses, and outline a literature review.
• Brainstorming product ideas – Produce feature lists, market angles, and MVP scopes while you sleep.
• Exploring technical trade‑offs – Compare architectures, list pros/cons, and surface hidden costs.
• Building knowledge tensors from codebases – Scan a repo, extract patterns, and create a living design document.
• Background thinking – Run a low‑budget session on a Raspberry Pi and get incremental insights every day.

• Compilation: gcc -o murmur c/murmur-cli.c -lm
• No Node.js: Ideal for constrained environments.
• Runs on: Raspberry Pi, Jetson, any POSIX‑compatible system.
• State location: ~/.murmur/ (separate from the repo to keep the binary lightweight).
• Same command surface as the TypeScript version.

Contributions are welcome! Please:

1. Fork the repo and create a feature branch.
2. Follow the existing code style (Prettier for TS, clang‑format for C).
3. Write tests for new functionality (npm test for TS, make test for C).
4. Submit a Pull Request with a clear description of the change.

See CONTRIBUTING.md for detailed guidelines.

Murmur‑Agent is released under the MIT License. See the LICENSE file for details.