AFC Commander (Free Edition)

# AFC Commander Free Edition

AFC Commander Free Edition is a JSON-backed command registry and pipeline runner with a Model Context Protocol (MCP) server for Cursor. It is built for teams that want a persistent alias layer for shell commands, profile-based separation between workspaces or projects, and repeatable command execution without hand-maintaining long terminal commands.

## What this project is for

AFC Commander solves a simple operational problem: teams accumulate important shell commands, but those commands are easy to lose, hard to standardize, and tedious to retype. This tool keeps those commands in a durable registry, lets you organize them by profile, and gives you a single command-line interface (CLI) for adding, listing, searching, and executing them.

The repository also includes a local MCP server named `afc-commander-core`, which exposes the same registry and execution capabilities to Cursor through standard input and standard output (stdio). That means agents can work with the command registry without needing direct shell access to your environment.

## Core capabilities

AFC Commander includes:

- Persistent command aliases stored in JSON.
- Profile isolation so different projects or environments can keep separate command sets.
- Command lookup, listing, editing, export, history, and statistics.
- Pipeline support for chaining multiple commands into a repeatable flow.
- Job tracking for longer-running or resumable executions.
- A local MCP server for agent access from Cursor.

## What it does not try to be

This is not a general-purpose task runner, and it is not a replacement for a full CI (continuous integration) system. It is a structured command registry and execution layer for shell workflows you want to keep organized, reusable, and accessible from both the terminal and MCP-aware tooling.

## Requirements

- Node.js 20.12 or newer. Node.js is the JavaScript runtime that executes the CLI and server code.
- npm, the Node.js package manager, for installation.
- Cursor, if you want to register and use the MCP server from the editor.

## Installation

From the repository root:

```bash
node setup.cjs

afc version
afc help
afc profile list

afc profile create myproject "My project"
afc profile switch myproject

afc add hello "echo hello" -d "Say hello"

afc -y hello

afc pipeline create
afc pipeline list
afc pipeline show my-deploy
afc pipeline execute my-deploy

node setup.cjs --mcp-only

node uninstall.cjs

node uninstall.cjs --purge-data