Installation
AgentsForms ships a CLI (@agentsforms/cli) for creating, validating, and publishing forms from the terminal. An HTTP API is also available for headless workflows.
System requirements
Section titled “System requirements”- Node.js 18 or later (LTS recommended)
- npm 9+ or pnpm 8+
- Internet connection (the CLI talks to the AgentsForms API)
Install via npm
Section titled “Install via npm”npm install -g @agentsforms/cliInstall via pnpm
Section titled “Install via pnpm”pnpm add -g @agentsforms/cliVerify
Section titled “Verify”agentsforms --versionExpected output:
agentsforms 0.1.0Install a specific version
Section titled “Install a specific version”npm install -g @agentsforms/cli@0.1.0Troubleshooting
Section titled “Troubleshooting”command not found: agentsforms
Section titled “command not found: agentsforms”Your global node_modules/.bin is likely not on $PATH. Run:
npm config get prefixAdd the printed path (with /bin appended) to your $PATH in .zshrc or .bashrc.
EACCES permission errors
Section titled “EACCES permission errors”Use a Node version manager (nvm, fnm, volta) instead of a system-installed Node. Version managers install global packages to your home directory, avoiding permission issues.
Proxy / firewall
Section titled “Proxy / firewall”Set the AGENTFORMS_API_URL environment variable if you need to route through a proxy or use a self-hosted API:
export AGENTFORMS_API_URL=https://api.agentsforms.com