Installation

CFactory IDE

CFactory IDE is the agentic editor for teams that ship — agents, MCP tools, and org rules built in from the first launch, not bolted on as an extension. Plan in the sidebar, run commands in the terminal, and keep the same runtime everywhere: the installer below includes the full cfactory CLI.

Pick your platform to download the latest build:

Checking for the latest IDE build…

After install, open a project folder, open the CFactory panel, and complete authentication.

CLI (included)

The full IDE package bundles the cfactory CLI with the built-in extension. You do not need a separate CLI install for normal use.

  • On Windows, the installer adds both cfactory-ide (editor) and cfactory (CLI) to your user PATH. From WSL, run cfactory-ide . like code .CFactory Remote - WSL is built into the IDE (Remote indicator → WSL Targets).
  • On macOS, use Shell Command: Install 'cfactory-ide' command in PATH (also installs cfactory), then open a new terminal.
  • On Linux, packages symlink both commands under /usr/bin.
cfactory-ide --version
cfactory --version

Use the same agent from a terminal — TUI, cfactory run, and cfactory serve. See the CLI guide.

Remote development (SSH + WSL)

CFactory IDE ships CFactory Remote - SSH and CFactory Remote - WSL as built-in extensions. They install the CFactory Remote Extension Host (cfactory-ide-server) from CFactory downloads — no Microsoft Remote-SSH / Remote-WSL.

FlowHow
Windows → WSLRemote indicator → WSL Targets, or cfactory-ide . inside WSL
Any client → Linux SSHRemote indicator → SSH Targets → Connect to Host…
Any client → Windows SSHEnable OpenSSH Server on the host, then Connect to Host…

Remote hosts need network access to https://ide-downloads.cfly.ai so the server binary can download. The CFactory agent (cfly.cfactory) is installed on new SSH hosts by default.

Next