Harnext

An AI coding agent with harness engineering. harnext is an interactive terminal agent that can read, write, and edit files, run shell commands, drive MCP servers, and pick up GitHub issues through generated GitHub Actions workflows (run on either GitHub-hosted runners or a self-hosted runner registered against your PC).

It works with Anthropic, OpenAI, Google, Ollama, and 20+ other providers via pi-ai.

Install

Requires Node.js ≥ 20.

npm (recommended)

npm install -g harnext

Then run:

harnext

On first run you'll be prompted to pick a provider, paste an API key (stored in ~/.harnext/agent/auth.json, mode 0600), and choose a model.

Command not found after install? Your current shell may have cached the old PATH. Run rehash (zsh) or hash -r (bash), or open a new terminal. New terminals pick up the binary automatically.

One-line install script

If you'd rather not invoke npm directly:

curl -fsSL https://raw.githubusercontent.com/yasha-dev1/codefactory/main/scripts/install.sh | bash

The script verifies Node ≥ 20 is on PATH and then runs npm install -g harnext.

From source

git clone https://github.com/yasha-dev1/codefactory.git
cd codefactory
npm install
npm run build
node packages/cli/dist/index.js

Quick start

harnext                                          # interactive REPL
harnext -p "list the files in this directory"    # one-shot prompt
harnext --provider openai -m gpt-4o              # different provider/model
harnext setup                                    # configure project pipeline
harnext status                                   # show active agent runs
harnext runner status                            # inspect the self-hosted runner daemon
harnext runner logs                              # tail the runner's diag log
harnext mcp --help                               # manage MCP servers

Pass -h / --help to any subcommand to see its flags.

Upgrade

npm update -g harnext

Uninstall

npm uninstall -g harnext

License

MIT — see LICENSE.