Metadata-Version: 2.4
Name: mlx-code
Version: 0.0.2a1
Summary: Local Claude Code for Mac
Home-page: https://github.com/JosefAlbers/mlx-code
Author: J Joe
Author-email: albersj66@gmail.com
License: Apache-2.0
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mlx-lm>=0.19.0
Requires-Dist: PyYAML
Dynamic: author
Dynamic: author-email
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# mlx-code

[![Link](https://raw.githubusercontent.com/JosefAlbers/mlx-code/main/assets/mlx-code.gif)](https://youtu.be/Rba-uTsYuXg)

### Quick Start

```bash
brew install --cask claude-code
pip install mlx-code
mlx-code
```

### Options

```bash
mlx-code [options] [-- claude options]
```

| Flag | Default | Description |
|------|---------|-------------|
| `--model` | `mlx-community/Qwen3.5-4B-OptiQ-4bit` | MLX model to load |
| `--port` | `8000` | Server port |
| `--host` | `127.0.0.1` | Server host |
| `--cache` | `cache/cache.safetensors` | Prompt cache file (saved/loaded across runs) |
| `--system` | None | System prompt override. Use `{env}` to inject working directory info |
| `--names` | `Read Edit Write Grep Glob Bash Agent Skill` | Tool names to pass through to the model |
| `--skips` | suggestion-mode block | Regex patterns to strip from message content |
| `--work` | `$CWD` | Working directory mirrored into the Claude session |
| `--home` | temp dir | Home directory for the Claude process |

Any extra arguments after `--` are forwarded to the `claude` CLI:

| Command | What it does | Example |
|--------|--------------|--------|
| `mlx-code` | Start interactive mode | `mlx-code` |
| `mlx-code "task"` | Run a one-time task | `mlx-code "fix the build error"` |
| `mlx-code -p "query"` | Run one-off query, then exit | `mlx-code -p "explain this function"` |
| `mlx-code -c` | Continue most recent conversation in current directory | `mlx-code -c` |
| `mlx-code -r` | Resume a previous conversation | `mlx-code -r` |
| `mlx-code commit` | Create a Git commit | `mlx-code commit` |
| `/clear` | Clear conversation history | `/clear` |
| `/help` | Show available commands | `/help` |
| `exit` or `Ctrl+C` | Exit Claude Code | `exit` |

### Licence

Apache License 2.0 — see LICENSE for details.


