# How to Install Archify Multi-Agent Support for Cursor, Codex, Claude-Code, and opencode

> Install Archify multi agent support for Cursor Codex Claude Code and Open Code using the skills CLI with the --agent flag. Get system-wide or project-local access easily.

- Repository: [tt-a1i/archify](https://github.com/tt-a1i/archify)
- Tags: how-to-guide
- Published: 2026-08-31

---

**Use the `skills` CLI with the `--agent` flag to install Archify as a skill for your target AI agent—choose `--global` for system-wide access or omit it for project-local installation.**

This guide walks you through installing Archify's multi-agent support as implemented in [tt-a1i/archify](https://github.com/tt-a1i/archify). Archify ships as a **Skill** that integrates with four supported agents: **Cursor**, **Codex**, **Claude-Code**, and **opencode**. The `skills` CLI handles agent-specific installation paths automatically.

## Prerequisites

- **Node.js and npm** installed for running `npx` commands
- One or more supported AI agents installed locally (Cursor, Codex CLI, Claude-Code, or opencode)

## Installation Methods for Each Agent

### Cursor Agent Installation

Install Archify globally for Cursor with an independent copy of the skill files:

```bash
npx -y skills add tt-a1i/archify \
    --skill archify \
    --agent cursor \
    --global \
    --copy \
    --yes

```

According to the source code in [`README.md`](https://github.com/tt-a1i/archify/blob/main/README.md) at lines 34 and 105, this command registers Archify with Cursor's runtime and copies all skill files so they don't depend on the npm cache.

The quick-start documentation is also available via the agent-aware URL: `https://tt-a1i.github.io/archify/start.html?agent=cursor&type=architecture`【README.md#L34】.

### Codex Agent Installation

For a project-local installation with Codex:

```bash
npx skills add tt-a1i/archify \
    --skill archify \
    --agent codex

```

As documented in [`README.md`](https://github.com/tt-a1i/archify/blob/main/README.md) at line 111, invoke Archify with: `npx skills use tt-a1i/archify@archify --agent codex`【README.md#L111】.

### Claude-Code and opencode Agents

The same pattern applies to the remaining supported agents. The CLI recognizes `--agent claude-code` and `--agent opencode` as valid targets【README.md#L116】.

```bash

# Claude-Code

npx skills use tt-a1i/archify@archify --agent claude-code

# opencode

npx skills use tt-a1i/archify@archify --agent opencode

```

## Using Archify After Installation

Once installed, run Archify through the `skills use` command with your selected agent:

```bash
npx skills use tt-a1i/archify@archify --agent cursor   # Cursor

npx skills use tt-a1i/archify@archify --agent codex    # Codex

npx skills use tt-a1i/archify@archify --agent claude-code # Claude-Code

npx skills use tt-a1i/archify@archify --agent opencode   # opencode

```

Alternatively, open the web-based **agent switcher** at `https://tt-a1i.github.io/archify/start.html?agent=cursor&type=architecture` to select from all four agents interactively【README.md#L116】.

## Optional: DeepSeek Harness Integration

For DeepSeek Harness support, install the community plugin separately:

```bash
dsh plugin --profile web add @tt-a1i/archify-dsh@0.1.0

```

This command is documented in [`README.md`](https://github.com/tt-a1i/archify/blob/main/README.md) at lines 114 and 265, and in [`integrations/deepseek-harness/README.md`](https://github.com/tt-a1i/archify/blob/main/integrations/deepseek-harness/README.md)【README.md#L114】【README.md#L265】.

## Key Configuration Files

Understanding these source files helps troubleshoot installation issues:

- **[`archify/SKILL.md`](https://github.com/tt-a1i/archify/blob/main/archify/SKILL.md)** — Defines the skill contract and lists all supported agents
- **[`README.md`](https://github.com/tt-a1i/archify/blob/main/README.md)** — Primary installation documentation (lines 34, 105, 111, 116)
- **[`archify/package.json`](https://github.com/tt-a1i/archify/blob/main/archify/package.json)** — Declares the npm package name `tt-a1i/archify` used by the CLI
- **[`integrations/deepseek-harness/README.md`](https://github.com/tt-a1i/archify/blob/main/integrations/deepseek-harness/README.md)** — DeepSeek Harness setup instructions

## Summary

- **Archify multi-agent support** is installed via the `skills add` CLI with the `--agent` flag
- **Four agents supported**: Cursor, Codex, Claude-Code, and opencode
- **Global vs. local**: Use `--global --copy` for system-wide access; omit for project-specific installs
- **Execution**: Run with `npx skills use tt-a1i/archify@archify --agent <agent>`
- **DeepSeek Harness**: Separate plugin installation via `dsh plugin --profile web add @tt-a1i/archify-dsh@0.1.0`

## Frequently Asked Questions

### What agents does Archify multi-agent support include?

Archify supports **Cursor**, **Codex**, **Claude-Code**, and **opencode** as documented in [`README.md`](https://github.com/tt-a1i/archify/blob/main/README.md) line 116 and [`archify/SKILL.md`](https://github.com/tt-a1i/archify/blob/main/archify/SKILL.md). The web-based agent switcher at [`tt-a1i.github.io/archify/start.html`](https://github.com/tt-a1i/archify/blob/main/tt-a1i.github.io/archify/start.html) provides a visual interface for selecting among all four.

### Do I need to install Archify separately for each agent?

**Yes.** Each agent maintains its own skill runtime location. Run `npx skills add` with the appropriate `--agent` flag for each agent you want to use. The `--global --copy` flags ensure the skill files are duplicated and available system-wide.

### What's the difference between global and local installation?

**Global installation** (`--global --copy`) places skill files in a system-wide location and creates an independent copy, making Archify available across all projects. **Local installation** registers the skill only for the current project without copying files, relying on the npm cache.

### Can I use Archify with DeepSeek models?

**Yes**, through the optional DeepSeek Harness integration. Install the community plugin with `dsh plugin --profile web add @tt-a1i/archify-dsh@0.1.0` as documented in [`integrations/deepseek-harness/README.md`](https://github.com/tt-a1i/archify/blob/main/integrations/deepseek-harness/README.md)【README.md#L265】.