> ## Documentation Index
> Fetch the complete documentation index at: https://docs.forest.app/llms.txt
> Use this file to discover all available pages before exploring further.

# forest skills:init

> Install the Forest skills for your coding agent in the current repository

# forest skills:init

Give your coding agent the Forest skills, so it knows how to customize the back-end code, edit layouts and write workflows with the Forest CLI. Run it from the root of your repository.

## Usage

```bash theme={null}
forest skills:init [options]
```

## Options

| Option | Description |
| - | - |
| `--agent` | Coding agent to set up: `claude`, `codex`, `cursor`, `opencode` or `other`. Repeat the option for several agents. Without it, the CLI detects the agents used in the repository and asks you to confirm |
| `--ref` | Version of the Forest skills to install, as a Git reference of the [ForestAdmin/ai-marketplace](https://github.com/ForestAdmin/ai-marketplace) repository. Default `main` |
| `--force` | Overwrite skill files installed by a previous run. Applies to copied skills only |

## What it installs

| Agent | Installation |
| - | - |
| Claude Code (`claude`), Codex (`codex`) | Installs the Forest plugins through the agent's own CLI, which must be on your `PATH` |
| Cursor (`cursor`), OpenCode (`opencode`), other agents (`other`) | Copies the skills into `.agents/skills/` in the repository |

The command also adds a Forest section to the agent's context file (`CLAUDE.md` for Claude Code, `AGENTS.md` for the others), and records what it installed in `.forest/skills-manifest.json` for [`forest skills:update`](https://docs.forest.app/reference/cli/skills-update).

Without `--agent`, the CLI detects agents from the files they leave in the repository, such as `.claude/`, `.codex/`, `.cursor/` or `opencode.json`. In a non-interactive terminal, it uses the detected agents directly, and fails if it detects none: pass `--agent` in that case.

## Examples

```bash theme={null}
# Detect the agents and confirm interactively
forest skills:init

# Set up Claude Code and Cursor
forest skills:init --agent claude --agent cursor

# Install a pinned version of the skills
forest skills:init --agent codex --ref <GIT_REF>
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.