# 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](/keeperpam/secrets-manager/integrations/ai-agents.md#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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.keeper.io/keeperpam/secrets-manager/integrations/ai-agents/manual-install.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
