Getting Started
Welcome to Dewey — a documentation toolkit that makes your docs AI-agent-ready.
Installation
Install the package using your preferred package manager:
npm install -D @arach/dewey
Or with pnpm:
pnpm add -D @arach/dewey
Quick Setup
Initialize your documentation structure:
npx dewey init
This creates a docs/ folder and a dewey.config.ts file:
import { defineConfig } from '@arach/dewey'export default defineConfig({ name: 'my-project', docs: './docs', output: { agentsMd: true, llmsTxt: true, installMd: true, },})
Note: Never expose your API key in client-side code. Use environment variables or a server-side proxy.
Core Concepts
Dewey is built around three key ideas:
- Agent Content Pattern — Each page has human (
.md) and agent (.agent.md) versions - Skills System — LLM prompts that guide AI agents through specific tasks
- install.md Standard — LLM-executable install instructions following the installmd.org spec
CLI Commands
| Command | Description |
|---|---|
dewey init | Create docs/ folder and config |
dewey audit | Check documentation completeness |
dewey generate | Create agent-ready files |
dewey agent | Score agent-readiness (0-100) |
Agent Readiness
npx dewey agent
What's Next
- Read the Configuration guide for advanced setup
- Explore the built-in skills for docs review and improvement