# Magic Device for AI coding assistants

The skill teaches your agent when to gate background work. The MCP server lets it check the API against the live docs. One command in your project installs the skill.

## Three pieces, one outcome.

The skill shapes what your agent writes, the MCP server checks it and llms.txt fills the gaps.

### Skill (edit time)

Teaches your agent the power, idle and fullscreen gates and how to test them before it writes the first line.

### MCP server (runtime)

Lets your agent look an API up in the live docs while it edits, so it never guesses a signature.

### llms.txt (on demand)

A plain-text map of every docs page, for agents that read it once and keep it in context.

## Three paths. Pick one for your editor.

Each path covers this skill; the plugin and the installer cover the whole registry.

### Claude Code plugin

Adds the registry as a marketplace, then installs its plugin.

```bash
/plugin marketplace add anilcancakir/ai
/plugin install anilcancakir@anilcancakir-marketplace
```

### npx skills (recommended)

The universal CLI. It works with the editors the skills package supports.

```bash
npx skills add anilcancakir/ai --skill magic-device
npx skills add anilcancakir/ai --skill magic-device -g
```

### Universal installer

Detects every supported editor and sets each one up the way it supports: skills, rules, commands or printed steps. It also adds the docs MCP server config.

```bash
git clone https://github.com/anilcancakir/ai.git && cd ai && bash scripts/install.sh --global --with-mcp
```

## Connect the MCP server.

One endpoint at `mcp.anilcancakir.com/magic_device`, six clients. Pick yours and paste the config.

(placeholder endpoint)

### Claude Code

`terminal`

```bash
claude mcp add --transport http magic_device https://mcp.anilcancakir.com/magic_device
```

### Cursor

`.cursor/mcp.json`

```json
{
    "mcpServers": {
        "magic_device": {
            "type": "http",
            "url": "https://mcp.anilcancakir.com/magic_device"
        }
    }
}
```

### OpenCode

`opencode.json`

```json
{
    "mcp": {
        "magic_device": {
            "type": "remote",
            "url": "https://mcp.anilcancakir.com/magic_device"
        }
    }
}
```

### VS Code Copilot

`.vscode/mcp.json`

```json
{
    "servers": {
        "magic_device": {
            "type": "http",
            "url": "https://mcp.anilcancakir.com/magic_device"
        }
    }
}
```

### Codex CLI

`~/.codex/config.toml`

```toml
[mcp_servers.magic_device]
url = "https://mcp.anilcancakir.com/magic_device"
```

### Antigravity CLI

`~/.gemini/config/mcp_config.json`

```json
{
    "mcpServers": {
        "magic_device": {
            "serverUrl": "https://mcp.anilcancakir.com/magic_device"
        }
    }
}
```

## LLM inventory files

Plain-text maps of the docs for agents that read on demand.

- [llms.txt](https://anilcancakir.com/magic_device/docs/llms.txt): An index of every docs page with its Markdown link.
- [llms-full.txt](https://anilcancakir.com/magic_device/docs/llms-full.txt): Every docs page in one file.

## Frequently asked

### Do I need both the skill and the MCP server?

No. The skill works alone and covers the conventions. The MCP server adds live tools while the agent works. Use both for the best result.

### Which AI coding assistants are supported?

The skill installs into Claude Code, Cursor, OpenCode, VS Code Copilot and Codex CLI. Any client that speaks MCP over HTTP or stdio can use the server.

### Does Magic Device need an account or a key?

No. Nothing on this page needs an account. An endpoint marked as a placeholder can still change.

### Where do I report a mistake?

Open an issue on the Magic Device repository on GitHub with the prompt, what your agent wrote and the docs page that says otherwise.