# Install agent-native-cli

> Build CLI tools that AI agents can operate reliably.

One skill, one repo. Choose your host below, run the command, the agent picks up `SKILL.md` on next launch. The same machine-readable manifest is at [`/skill.json`](https://anc.dev/skill.json).

## Choose your host

### Claude Code

```bash
git clone --depth 1 https://github.com/brettdavies/agentnative-skill.git ~/.claude/skills/agent-native-cli
```

### Codex

```bash
git clone --depth 1 https://github.com/brettdavies/agentnative-skill.git ~/.codex/skills/agent-native-cli
```

### Cursor

```bash
git clone --depth 1 https://github.com/brettdavies/agentnative-skill.git ~/.cursor/skills/agent-native-cli
```

### Factory Droid

```bash
git clone --depth 1 https://github.com/brettdavies/agentnative-skill.git ~/.factory/skills/agent-native-cli
```

### Kiro

```bash
git clone --depth 1 https://github.com/brettdavies/agentnative-skill.git ~/.kiro/skills/agent-native-cli
```

### OpenCode

```bash
git clone --depth 1 https://github.com/brettdavies/agentnative-skill.git ~/.config/opencode/skills/agent-native-cli
```

## What this does

Clones `https://github.com/brettdavies/agentnative-skill.git` into your host's skills directory. `.git/` is preserved so future updates are a `git pull`.

## Already installed?

If the destination directory already holds this skill (origin matches), update in place:

```bash
cd <install-dir> && git pull --ff-only
```

If it holds something else, remove it first, then re-run the install command:

```bash
rm -rf <install-dir>
```

## Update

```bash
cd <install-dir> && git pull --ff-only
```

To pin a specific release: `git checkout <tag>` after pulling. Tags follow `vX.Y.Z` semver.

## Uninstall

```bash
rm -rf <install-dir>
```

## Trust model

Piping a remote shell script into the local shell is the failure mode this install path rejects. Installation runs `git clone` against a specific repository on a specific host — the scripts are open-source and visible at the producer repo before they execute on the user's machine.

## Programmatic

Agents fetch [`/skill.json`](https://anc.dev/skill.json) for the canonical manifest — `Content-Type: application/json`, `Accept: text/markdown` returns the JSON unchanged.