# WrongStack — llms.txt

Built on the wrong stack. Shipped anyway. CLI AI coding agent.

## Install

    npm install -g wrongstack

## Minimal config

    # ~/.wrongstack/config.json
    {
      "version": 1,
      "provider": "anthropic",
      "model": "claude-sonnet-4-6",
      "apiKey": "sk-ant-..."
    }

## CLI surface

    wstack                         # REPL
    wstack "<task>"                # single-shot
    wstack resume [<id>]           # continue session
    wstack init                    # scaffold
    wstack diag                    # diagnostics
    wstack version

## Slash commands (in REPL)

    /help /clear /compact [aggressive] /usage /tools
    /skill [name] /use <provider> /model <name> /save /load /exit
    /plugin [list|install|enable|disable|remove]

## Built-in tools

    read write edit replace glob grep tree patch diff json
    bash exec git
    fetch search
    lint format typecheck test install audit outdated logs document scaffold
    todo plan tool-search tool-use batch-tool-use tool-help
    context-manager memory mode

## Providers

    anthropic openai openai-compatible
    Presets: groq, deepseek, moonshot, glm, ollama, openrouter,
             fireworks, together, xai, cerebras

## Override surface

    Container.bind / override / decorate
    Pipeline.use / prepend / insertBefore / insertAfter / replace / remove
    ToolRegistry.register / replace / unregister
    ProviderRegistry.register
    EventBus.on (observe-only)

## Plugin contract

    interface Plugin {
      name: string;
      apiVersion: string;
      dependsOn?: string[];
      conflictsWith?: string[];
      setup(api: PluginAPI): void | Promise<void>;
      teardown?(api: PluginAPI): void | Promise<void>;
    }
