opencode-muse-code

# opencode-muse-code

[![npm version](https://img.shields.io/npm/v/opencode-muse-code.svg)](https://www.npmjs.com/package/opencode-muse-code)
[![license](https://img.shields.io/npm/l/opencode-muse-code.svg)](./LICENSE)

Use a **Muse Code** (Meta) subscription in [OpenCode](https://opencode.ai).

The plugin reads the login the [`muse`](https://api.meta.ai/muse-launcher.sh) CLI
already stored on your machine, registers a `muse-code` provider that talks to
`https://api.meta.ai/v1`, and discovers the available Muse models on startup and
every 30 minutes. Model requests are metered by Meta against your Muse Code
subscription — OpenCode needs no API key in its own configuration.

```text
OpenCode  ──▶  https://api.meta.ai/v1  ──▶  Muse Code subscription
                    ▲
    minted API key from the muse CLI login
```

## Features

- Zero configuration once the `muse` CLI is signed in.
- Live model discovery with real context/output limits, tool support, input
  types, and reasoning-effort variants.
- Reads credentials from the macOS keychain (or `~/.config/muse/auth.json`),
  with `META_API_KEY` / `MUSE_API_KEY` and an explicit `key` option as
  fallbacks.
- Never writes credentials to OpenCode configuration or the repository.

## Requirements

- OpenCode V2 (tested on 2.0.8).
- The `muse` CLI installed and signed in — run `muse` once if you have not.
- An active Muse Code subscription. Check with the `muse` CLI or the
  [Muse Code page](https://accountscenter.meta.com/muse_code/).

## Install

```sh
opencode plugin add opencode-muse-code
```

Or add it to the `plugins` list in `opencode.jsonc` yourself:

```jsonc
{
  "plugins": ["opencode-muse-code"]
}
```

Pin a version if you prefer:

```jsonc
{
  "plugins": ["opencode-muse-code@0.1.2"]
}
```

Restart the service after changing configuration:

```sh
opencode service restart
```

<details>
<summary>Install from source instead</summary>

```sh
git clone https://github.com/swalker326/opencode-muse-code.git
```

```jsonc
{
  "plugins": ["/absolute/path/to/opencode-muse-code"]
}
```

Or copy the folder to `~/.config/opencode/plugins/muse-code/`, where plugin
directories load automatically.
</details>

## Use

Pick a model with `/models` in the TUI, or run one directly:

```sh
opencode run --model muse-code/muse-spark-1.3 "Summarize this repository"
```

### Models

Models are discovered from Meta's catalog, so t