# Manual Install

This guide covers manual installation by cloning the GitHub repo. Use this method if you're in an air-gapped environment, don't have Node.js, or need full control over what gets installed. For faster setup, see all the available [installation methods](https://docs.keeper.io/en/keeperpam/secrets-manager/integrations/ai-agents/..#installation) we support for AI Agents.

***

### Step 1: Clone the Repo

```bash
git clone https://github.com/Keeper-Security/keeper-agent-kit
cd keeper-agent-kit
```

### Step 2: Copy Skills to Your Agent

Each agent reads skills from a different directory. Find your agent below and copy the files there.

| Agent                  | Skills Path           |
| ---------------------- | --------------------- |
| Claude Code (global)   | `~/.claude/skills/`   |
| Claude Code (project)  | `./.claude/skills/`   |
| Cursor (global)        | `~/.cursor/skills/`   |
| Cursor (project)       | `./.cursor/skills/`   |
| Codex                  | `~/.codex/skills/`    |
| GitHub Copilot         | `~/.github/skills/`   |
| VS Code (Copilot Chat) | `./.github/skills/`   |
| OpenCode               | `~/.opencode/skills/` |
| Gemini CLI             | `~/.gemini/skills/`   |

**Example: Claude Code (global install)**

```bash
mkdir -p ~/.claude/skills
cp -r plugins/*/skills/* ~/.claude/skills/
```

**Example: Claude Code (project-level, shared with your team)**

```bash
mkdir -p .claude/skills
cp -r plugins/*/skills/* .claude/skills/
```

Then commit `.claude/skills/` to your repo so collaborators get the same skills.

**Example: Cursor**

```bash
mkdir -p ~/.cursor/skills
cp -r plugins/*/skills/* ~/.cursor/skills/
```

### Step 3: Verify

After copying, restart your agent session. Then test with a prompt like:

> "How do I list my KSM profiles?"

If the agent responds with `ksm profile list`, the skills are loaded.

In Claude Code, you can also check `/plugin` → **Installed** tab.

***

### Installing Individual Skills

If you only need one skill, copy just that folder:

```bash
# Only the secrets skill
cp -r plugins/keeper-secrets/skills/keeper-secrets ~/.claude/skills/

# Only the admin skill
cp -r plugins/keeper-admin/skills/keeper-admin ~/.claude/skills/

# Only the setup skill
cp -r plugins/keeper-setup/skills/keeper-setup ~/.claude/skills/
```

***

### Multi-Agent Setup

If you use more than one agent, you can install to all of them from the same clone:

```bash
# Claude Code + Cursor + Codex
for dir in ~/.claude/skills ~/.cursor/skills ~/.codex/skills; do
  mkdir -p "$dir"
  cp -r plugins/*/skills/* "$dir/"
done
```

Or use symlinks so updates apply everywhere:

```bash
CANONICAL=~/.agent-skills/keeper
mkdir -p "$CANONICAL"
cp -r plugins/*/skills/* "$CANONICAL/"

# Symlink into each agent
ln -sf "$CANONICAL"/keeper-secrets ~/.claude/skills/keeper-secrets
ln -sf "$CANONICAL"/keeper-secrets ~/.cursor/skills/keeper-secrets
# ... repeat for each skill and agent
```

***

### Updating

Pull the latest from GitHub and re-copy:

```bash
cd keeper-agent-kit
git pull
cp -r plugins/*/skills/* ~/.claude/skills/
```

***

### Uninstall

Delete the skill directories from your agent's skills folder:

```bash
rm -rf ~/.claude/skills/keeper-secrets
rm -rf ~/.claude/skills/keeper-admin
rm -rf ~/.claude/skills/keeper-setup
```

Repeat for any other agents where you installed them.

This only removes the agent skills. The KSM CLI and Commander CLI stay installed on your machine.