Getting Started/Getting Started

Getting Started

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:

  1. Agent Content Pattern — Each page has human (.md) and agent (.agent.md) versions
  2. Skills System — LLM prompts that guide AI agents through specific tasks
  3. install.md Standard — LLM-executable install instructions following the installmd.org spec

CLI Commands

CommandDescription
dewey initCreate docs/ folder and config
dewey auditCheck documentation completeness
dewey generateCreate agent-ready files
dewey agentScore 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