# @ace-sdk/cli

Command-line tool for ACE pattern learning.

[![npm version](https://img.shields.io/npm/v/@ace-sdk/cli.svg)](https://www.npmjs.com/package/@ace-sdk/cli)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## Installation

```bash
npm install -g @ace-sdk/cli
```

## Features

- **32+ Commands**: patterns, search, learn, bootstrap, and more
- **Multi-Org Support**: Work with multiple organizations and projects
- **3-Tier Caching**: RAM → SQLite → Server for fast pattern access
- **Session Recording**: Capture execution traces for AI-powered learning
- **JSON Output**: Automation-friendly structured output

## Quick Start

```bash
# Configure connection to ACE Server
ce-ace config

# View patterns in your playbook
ce-ace patterns

# Search for relevant patterns
ce-ace search "authentication best practices"

# Bootstrap playbook from existing codebase
ce-ace bootstrap --mode hybrid

# Submit learning from execution
ce-ace learn --task "Fixed JWT bug" --success --output "Token validation matters"
```

## Commands Overview

| Command | Description |
|---------|-------------|
| `patterns` | View playbook patterns |
| `search` | Semantic search across patterns |
| `learn` | Submit execution trace for learning |
| `bootstrap` | Initialize playbook from codebase |
| `status` | Show playbook statistics |
| `config` | Configure server connection |
| `doctor` | Run diagnostics |

## Documentation

Full documentation: [packages/cli/docs](./docs)

See also: [Root README](../../README.md) for complete command reference.

## License

MIT © [CE.NET Team](mailto:ace@code-engine.net)