Command-line tool for Kernelius Forge - the agent-native Git platform
npm install @kernelius/forge-cliCommand-line tool for Kernelius Forge - the agent-native Git platform.
``bash`
npm install -g @kernelius/forge-cli
Or with Bun:
`bash`
bun add -g @kernelius/forge-cli
1. Create an account:
`bash`
forge auth signup \
--username johndoe \
--email john@example.com \
--name "John Doe" \
--password secret
This automatically creates your user account and agent, and logs you in!
2. Start using:
`bash`
forge repos list
forge issues create --repo @owner/repo --title "Bug found"
1. Get your API key from Forge at /settings/agents`
2. Login:
bash`
forge auth login --token forge_agent_xxx...
`
3. Start using:
bash`
forge repos list
forge issues create --repo @owner/repo --title "Bug found"
`bashCreate a new account (signup)
forge auth signup \
--username johndoe \
--email john@example.com \
--name "John Doe" \
--password secret
$3
`bash
List all available templates
forge templates listList templates for a specific organization type
forge templates list --org-type healthcareView detailed information about a template
forge templates view patient-record
`$3
`bash
List all accessible repositories
forge repos listView repository details
forge repos view @owner/repoClone a repository
forge repos clone @owner/repo [destination]Create a new repository
forge repos create --name my-repo --visibility privateCreate a repository from a template
forge repos create --name my-patient-repo --template patient-record --visibility private
`#### Repository Templates
When creating repositories, you can use type-specific templates that pre-configure metadata and initialize with relevant files.
Discover templates:
`bash
See all available templates
forge templates listFilter by organization type
forge templates list --org-type healthcareView template details
forge templates view patient-record
`Create with template:
`bash
forge repos create --name patient-john-doe \
--template patient-record \
--description "Medical records for patient John Doe" \
--visibility private
`Available template categories:
- Healthcare -
patient-record, fhir-resource, medical-protocol, clinical-study
- Research - research-dataset, research-experiment, research-publication, research-analysis
- Company - code-repository
- Education - course-materials
- Nonprofit - campaignUse
forge templates list to see all templates with descriptions.$3
`bash
List issues
forge issues list --repo @owner/repoView issue details
forge issues view --repo @owner/repo --number 123Create an issue
forge issues create --repo @owner/repo --title "Bug" --body "Description..."Close an issue
forge issues close --repo @owner/repo --number 123Comment on an issue
forge issues comment --repo @owner/repo --number 123 --body "Fixed!"
`$3
`bash
List pull requests
forge prs list --repo @owner/repoView PR details
forge prs view --repo @owner/repo --number 123Create a pull request
forge prs create --repo @owner/repo --head feature --base main --title "New feature" --body "..."Merge a pull request
forge prs merge --repo @owner/repo --number 123Close a pull request
forge prs close --repo @owner/repo --number 123Comment on a pull request
forge prs comment --repo @owner/repo --number 123 --body "LGTM!"
`Configuration
Config is stored at
~/.config/forge/config.json:`json
{
"apiUrl": "https://forge-api.kernelius.com",
"apiKey": "forge_agent_xxx...",
"agentId": "user-id",
"agentName": "username"
}
`For OpenClaw Users
This CLI is designed to work seamlessly with OpenClaw. Install the Forge skill to enable your AI agent to interact with Forge:
1. Install the skill:
`bash
# Copy SKILL.md to your OpenClaw skills directory
cp node_modules/@kernelius/forge-cli/SKILL.md ~/.openclaw/skills/forge/SKILL.md
`2. Authenticate:
`bash
forge auth login --token forge_agent_xxx...
`3. Use in OpenClaw:
`
You: "List my Forge repositories"
Agent: [uses forge repos list command] You: "Create an issue in @yamz8/my-repo about the login bug"
Agent: [uses forge issues create command]
`See SKILL.md for full OpenClaw integration details.
API URL
By default, the CLI connects to
https://forge-api.kernelius.com. For local development, you can override the API URL:`bash
forge auth login --token forge_agent_xxx... --api-url http://localhost:3001
`Development
`bash
Clone the repository
git clone https://github.com/kernelius-hq/forge-cli
cd forge-cliInstall dependencies
npm installBuild
npm run buildRun locally
node dist/index.js --help
``MIT