Something went wrong. Try again.
Monorepo for Aesthetic.Computer aesthetic.computer
Something went wrong. Try again.
Markdown
# CLI Documentation Explorer for Aesthetic Computer
*Specification for command-line documentation browsing and Emacs integration*
## Overview
A command-line documentation explorer that provides fast access to Aesthetic Computer documentation, similar to the existing `kidlisp-tools` CLI interface. This tool will integrate with Emacs to provide a 'docs' tab alongside or replacing the current 'code' tab.
## CLI Tool Specification
### Command Structure
```bash
ac-docs [command] [options]
```
### Core Commands
#### `ac-docs search <query>`
Search across all documentation:
```bash
ac-docs search "wipe" # Find all references to wipe function
ac-docs search "pointer" # Find pointer/input documentation
ac-docs search "kidlisp circle" # Find KidLisp circle function
```
#### `ac-docs api [function]`
Browse JavaScript API documentation:
```bash
ac-docs api # List all API categories
ac-docs api graphics # Show graphics functions
ac-docs api wipe # Show detailed wipe function info
ac-docs api --examples box # Show box function with examples
```
#### `ac-docs kidlisp [topic]`
Browse KidLisp language documentation:
```bash
ac-docs kidlisp # Show language overview
ac-docs kidlisp syntax # Basic syntax guide
ac-docs kidlisp functions # List all functions
ac-docs kidlisp circle # Show circle function details
ac-docs kidlisp --examples # Show example programs
```
#### `ac-docs pieces [name]`
Browse piece documentation:
```bash
ac-docs pieces # List documented pieces
ac-docs pieces structure # Show piece lifecycle info
ac-docs pieces template # Show piece templates
ac-docs pieces paint-canvas # Show specific piece docs
```
#### `ac-docs coverage`
Show documentation coverage reports:
```bash
ac-docs coverage # Overall coverage summary
ac-docs coverage api # API documentation coverage
ac-docs coverage pieces # Piece documentation coverage
ac-d…