@netrodev/hxf-coding-agent
v1.0.18
Published
Coding agent CLI with read, bash, edit, write tools and session management
Maintainers
Readme
New issues and PRs from new contributors are closed automatically. Maintainers review closed submissions daily. See CONTRIBUTING.md.
HowToFix
HowToFix is a minimal, extensible agent harness that you can make your own.
Adapt HowToFix to your workflows, not the other way around. Customize HowToFix with extensions, skills, prompt templates, and themes. Bundle them as HowToFix packages and share via npm or git.
HowToFix ships with powerful defaults but skips features like sub-agents and plan mode. Ask HowToFix to build what you want, or install a package that does it your way.
Use HowToFix interactively, automate it in print or JSON mode, control it over RPC, or build apps with the HowToFix TypeScript SDK. See OpenClaw for a real-world integration.
Getting started
Install the command-line interface:
curl -fsSL https://howtofix.id/install.sh | shOn Windows:
powershell -c "irm https://howtofix.id/install.ps1 | iex"The installer pins all dependencies and updates HowToFix with hxf update. Alternatively, install directly with npm, which does not pin transitive dependencies:
npm install -g --ignore-scripts @netrodev/hxf-coding-agentHowToFix requires Node.js 22.19 or newer. The macOS, Linux, and Windows installers can install it if needed. HowToFix does not require dependency lifecycle scripts for a normal npm installation.
On macOS and Linux, Nix users can install the latest release with nix profile add github:NetroIndonesia/howtofix-harness/stable. See the quickstart for updating and pinning releases.
Start HowToFix in the directory where you want it to work:
cd /path/to/project
hxfFor a built-in AI provider, run /login inside HowToFix to connect a subscription or API key. Then give HowToFix a task.
See the documentation for full setup and usage instructions.
Sharing sessions
This is a private fork. Session sharing is disabled by default: the session-upload
path points at a reserved non-resolving host, so nothing leaves the machine until
a gateway is configured deliberately (HXF_RADIUS_GATEWAY).
Development
Clone the repository, install its dependencies, and run HowToFix from source:
git clone https://github.com/NetroIndonesia/howtofix-harness
cd hxf
npm install --ignore-scripts
./hxf-test.shhxf-test.sh can be called from any directory and preserves the caller's working directory.
Before submitting changes, run:
npm run check
./test.shRead CONTRIBUTING.md before opening an issue or pull request. It defines the contribution gate, issue quality bar, and required checks. Read AGENTS.md for repository-specific implementation, testing, dependency, and release rules.
License
MIT
