Monorepo for Aesthetic.Computer aesthetic.computer
core reference tools cli-explorer.md
8.7 kB · 301 lines

# 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…