clawcode

# ClawCode CLI

CLI coding agent (**ClawCode**) that uses **Azure OpenAI**, **Groq**, or **Google Gemini** to plan and apply code changes. It scans your project (respecting `.gitignore`), sends minimal context to the LLM, and applies structured patches with backups and confirmation. Persistent memory (global + per-project session) survives restarts and model switches.

- **Website:** [https://clawcode.vercel.app/](https://clawcode.vercel.app/)
- **Documentation:** [https://clawcode.vercel.app/docs](https://clawcode.vercel.app/docs)

## Requirements

- **Node.js** >= 18
- At least one AI provider configured (Azure OpenAI, Groq, or Google Gemini)

---

## Installation

Install into user space (no `sudo`, no global npm). Requires Node.js >= 18.

**macOS / Linux:**

```bash
curl -fsSL https://raw.githubusercontent.com/sarhan44/clawcode/main/install.sh | bash
```

**Windows (PowerShell):**

```powershell
iwr https://raw.githubusercontent.com/sarhan44/clawcode/main/install.ps1 -useb | iex
```

Then run:

```bash
clawcode
```

On first run, ClawCode will guide you through configuring an AI provider. You can also run `clawcode config` any time to add/update providers.


<img width="1906" height="824" alt="image" src="https://github.com/user-attachments/assets/be90d8ea-5630-435d-ba77-778b41b3071d" />


*ClawCode interactive UI: logo, project/provider info, activity feed, status bar, and task input.*

---

## Commands

| Command | Description |
|--------|-------------|
| `clawcode` | Open the interactive TUI (default). Select project and provider, then enter tasks. |
| `clawcode config` | Add or update AI provider credentials (API keys, endpoints). |
| `clawcode shell` | Start REPL mode with `clawcode>` prompt. Use `:exit`, `:provider`, `:project`, `:help`. |
| `clawcode "task"` | Run a single task in the current directory (no TUI). |
| `clawcode --dir <path> "task"` | Run a task in the specified project directory. |

### Options

| Option | Description |
|--------|----------