AgentForge

# AgentForge

[English](README.md) | [简体中文](README.zh-CN.md)

A CLI for managing and syncing skills across Claude Code, Codex, Cursor CLI, OpenClaw, Cursor, OpenCode, Qoder, and project workspaces.

[![CI](https://github.com/redker56/agentforge/actions/workflows/ci.yml/badge.svg)](https://github.com/redker56/agentforge/actions/workflows/ci.yml)
[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Node.js Version](https://img.shields.io/node/v/%40redker56%2Fagentforge.svg)](package.json)

## Requirements

- Node.js 18 or newer
- `git` available in `PATH`
- CI currently covers Ubuntu and Windows on Node 18 / 20 / 22

## Installation

```bash
npm install -g @redker56/agentforge
```

Recommended next steps:

```bash
af --help
af completion --install
```

AgentForge does not automatically modify your shell configuration during installation.

To enable shell completion explicitly, run:

```bash
af completion --install
```

Re-running the same command updates the existing AgentForge completion block in place.

If shell auto-detection fails, specify it directly:

```bash
af completion powershell --install
af completion bash --install
```

## Commands

### View Commands

```bash
# List all skills (show user-level and project-level distribution)
af list skills

# List available Agents (show user-level and project-level skills)
af list agents

# List registered projects
af list projects

# Show skill details
af show skills <name>

# Show Agent details (and installed skills)
af show agents <id>

# Show project details (and contained skills, mark import status)
af show projects <id>
```

`af list agents` groups project-level skills by project for easier scanning. The project-level count is the total number of skills across all grouped projects.

```text
cursor - Claude Code
  Project-level (3):
    Obsidian:
      defuddle
      json-canvas
    Voice:
      frontend-design
```

### Add Commands

```bash
# Install skill from Git repository
af add skills