oeo

Monkdev — AI skill for Claude Code

AI community

A holy, minimalist CLI toolkit and MCP server designed exclusively for LLM coding agents.

How to install Monkdev

This entry records only its repository, not the path inside it, so there is no exact command to give. Open oeo/monkdev and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Monkdev does

A holy, minimalist CLI toolkit and MCP server designed exclusively for LLM coding agents.

Alternatives in AI

Firecrawl MCP Server — 🔥 Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM c 6.1k ★
Peekaboo — Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, o 3.2k ★
Vllm Mlx — High-performance OpenAI and Anthropic compatible LLM inference server for Apple Silicon 1.5k ★

README

monk seated in meditation

Monkdev

Opinionated roleplay for efficient context frontloading and general agentic workflow automation.

Monkdev combines token-aware codebase tools with a resident engineering methodology. Tools map and ingest source. Directives make agents seek root causes, prefer smaller fixes, prove changes, and preserve reasoning in git.

Setup

Required:

[Bun](https://bun.sh) and git.
[Caveman](https://github.com/JuliusBrussee/caveman) for terse agent output:
```
npx skills add JuliusBrussee/caveman
```
A [Brave Search API token](https://brave.com/search/api/) for `brave-search` and `#do_r`. Store it after installing Monkdev:
```
cp ~/.monkdev/.env.example ~/.monkdev/.env
# replace BRAVE_API_KEY in ~/.monkdev/.env
```
Google Chrome or Chromium for `fetch-url` and `screenshot-url`. Set `MONK_CHROME` when its binary is outside an auto-detected path.

Install or upgrade Monkdev:

curl -fsSL https://raw.githubusercontent.com/oeo/monkdev/master/scripts/install.sh | bash

Installer clones to `~/.monkdev`, installs dependencies, registers available agent integrations, and merges directives between markers without replacing operator content. Restart agent session, then verify `monk_tree` responds.

Use [`INSTALL.md`](INSTALL.md) for manual or unsupported-scaffold setup. Review [`scripts/install.sh`](scripts/install.sh) before piping it into a shell.

In-Scaffold Workflow

Type these into your coding agent. They are directives, not shell commands.

**Understand before changing:**

#med on packages/auth

**Plan, attack, and implement in an isolated worktree:**

#plan consolidate token validation at its source | #attack 3
implement this plan

Attackers check root-cause placement, simpler options, overengineering, maintainability, scope creep, pragmatism, net LOC, and test value. Result stays paused until