# Installing arcforge for Codex

Enable agentic skills in Codex via native skill discovery. One clone, one symlink.

## Prerequisites

- Git
- Node.js — the arcforge CLI (`scripts/cli.js`) runs on Node; skills that
  call it need it on your `PATH`

## Installation

1. **Clone arcforge:**
   ```bash
   git clone https://github.com/GregoryHo/arcforge ~/.agents/arcforge
   ```

   This is the **standard clone location**, and skills resolve the CLI
   through `ARCFORGE_ROOT`. Codex has no SessionStart hook to export it, so
   skills fall back to `~/.agents/arcforge` automatically. If you clone
   somewhere else, export it in your shell profile so the CLI resolves:
   ```bash
   export ARCFORGE_ROOT=/your/arcforge/checkout
   ```

2. **Create the skills directory:**
   ```bash
   mkdir -p ~/.agents/skills
   ```

3. **Symlink skills into the shared directory:**
   ```bash
   ln -s ~/.agents/arcforge/skills ~/.agents/skills/arcforge
   ```

4. **Restart Codex** to discover the skills.

## Verify

```bash
ls -la ~/.agents/skills/arcforge
```

You should see a symlink pointing to `~/.agents/arcforge/skills`.

## Updating

```bash
cd ~/.agents/arcforge && git pull
```

Skills update instantly through the symlink — all platforms sharing this clone get updated at once.

## Uninstalling

```bash
unlink ~/.agents/skills/arcforge
```

To also remove the clone:

```bash
rm -rf ~/.agents/arcforge
```
