AFC Commander Free Edition

AFC Commander Free Edition is a command registry and pipeline runner with a Cursor-compatible Model Context Protocol (MCP) server. It gives you a persistent alias layer for shell commands, profile isolation for different workspaces or projects, and a single stdio MCP server named afc-commander-core.

What it does

• afc is the command-line interface (CLI) for adding, listing, searching, and running commands by alias.

• Profiles let you isolate command sets by project or workflow.

• Pipelines let you chain commands into repeatable execution flows.

• The MCP server exposes the same registry and execution features to Cursor agents through one local server entrypoint.

Requirements

• Node.js 20.12 or newer

• npm

• Cursor if you want to use the MCP server

Install

From the repository root:

node setup.cjs

That setup script will:

1. Install the package dependencies.

2. Install afc-commander-free globally with npm so the afc command is available on your system.

3. Create a user data directory at ~/.afc-commander unless you override it with AFC_HOME.

4. Register the afc-commander-core MCP server in ~/.cursor/mcp.json.

After installation, reload MCP in Cursor.

Verify the install

afc version
afc help
afc profile list

First commands

afc help
afc help list
afc profile list
afc profile create myproject "My project"
afc profile switch myproject
afc add hello "echo hello" -d "Say hello"
afc -y hello

MCP tools

The free edition exposes 11 MCP tools through a single stdio server named afc-commander-core.

• afc-list-commands

• afc-search-commands

• afc-execute-command

• afc-add-command

• afc-remove-command

• afc-list-profiles

• afc-create-profile

• afc-switch-profile

• afc-list-pipelines

• afc-create-pipeline

• afc-execute-pipeline

Data locations

• Package code: installed globally by npm

• User data: ~/.afc-commander

• MCP config: ~/.cursor/mcp.json

• Install record: ~/.afc-commander/install.json

Set AFC_HOME to move the user data directory to another path.

Useful commands

Refresh MCP paths after moving the global package:

node setup.cjs --mcp-only

Uninstall:

node uninstall.cjs

Remove user data too:

node uninstall.cjs --purge-data

Project layout

• afc-commander/ — CLI package and command implementation

• server.js — MCP stdio entrypoint

• tools/afc-commander/ — MCP tool handlers

• setup.cjs — install script

• uninstall.cjs — uninstall script

• docs/ — install, usage, MCP, and troubleshooting notes

Notes

This repository is source-available under the license in LICENSE.md. It is not GPLv3.