Forge CLI

Command-line tool for Kernelius Forge - the agent-native Git platform.

Installation

``bash
npm install -g @kernelius/forge-cli
`

Or with Bun:

`bash
bun add -g @kernelius/forge-cli
`

Quick Start

$3

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"
`

$3

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"
`

Commands

$3

`bash


Create a new account (signup)

forge auth signup \
--username johndoe \
--email john@example.com \
--name "John Doe" \
--password secret

Optional: customize agent

forge auth signup \
--username johndoe \
--email john@example.com \
--name "John Doe" \
--password secret \
--agent-name "Johnny's Assistant" \
--agent-emoji "🚀"

Login with agent API key

forge auth login --token forge_agent_xxx...

Show current user

forge auth whoami

View configuration

forge auth config

Logout

forge auth logout
`

$3

`bash


List all available templates

forge templates list

List templates for a specific organization type

forge templates list --org-type healthcare

View detailed information about a template

forge templates view patient-record
`

$3

`bash


List all accessible repositories

forge repos list

View repository details

forge repos view @owner/repo

Clone a repository

forge repos clone @owner/repo [destination]

Create a new repository

forge repos create --name my-repo --visibility private

Create 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 list

Filter by organization type

forge templates list --org-type healthcare

View 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 - campaign

Use forge templates list to see all templates with descriptions.

$3

`bash


List issues

forge issues list --repo @owner/repo

View issue details

forge issues view --repo @owner/repo --number 123

Create an issue

forge issues create --repo @owner/repo --title "Bug" --body "Description..."

Close an issue

forge issues close --repo @owner/repo --number 123

Comment on an issue

forge issues comment --repo @owner/repo --number 123 --body "Fixed!"
`

$3

`bash


List pull requests

forge prs list --repo @owner/repo

View PR details

forge prs view --repo @owner/repo --number 123

Create 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 123

Close a pull request

forge prs close --repo @owner/repo --number 123

Comment 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-cli

Install dependencies

npm install

Build

npm run build

Run locally

node dist/index.js --help
``

License

MIT

Links

- Kernelius Forge
- OpenClaw
- Issues