SmolForge CLI

Command-line interface for the SmolForge API.

npm install -g @smolai/forge
sf --help

The default API base URL is https://forge.smol.ai. Override it with --api-url or SMOLFORGE_API_URL.

Authentication

sf auth register --username alice --email [email protected] --password "$PASSWORD"
sf auth login --username alice --password "$PASSWORD"
sf auth status
sf auth logout

The CLI stores the bearer token in ~/.config/smolforge/config.json. You can also pass --token or set SMOLFORGE_TOKEN.

Repositories

sf repo create my-repo --description "Example" --private
sf repo get alice my-repo
sf repo contents alice my-repo README.md
sf repo commits alice my-repo
sf repo clone alice my-repo

Transcripts

sf transcript upload alice my-repo ~/.codex/sessions/2026/03/29/session.jsonl --commit-sha <sha>

Workflows

sf workflow put alice my-repo ci.yml .github/workflows/ci.yml
sf workflow run alice my-repo ci.yml
sf workflow list-runs alice my-repo
sf secret set alice my-repo NPM_TOKEN --value "$NPM_TOKEN"

Issues, Pull Requests, and Webhooks

sf issue create alice my-repo --title "Bug" --body "Details"
sf issue list alice my-repo
sf pull create alice my-repo --title "Feature" --head-branch feature --base-branch main
sf pull list alice my-repo
sf webhook create alice my-repo --url https://example.com/hook --event push --event pull_request --secret "$SECRET"
sf webhook list alice my-repo

Output

Most commands print formatted JSON. Use --raw for unformatted JSON.

Npm Publish

pnpm --filter @smolai/forge pack:dry-run
pnpm --filter @smolai/forge publish --access public

Homebrew

After publishing to npm, update homebrew/smolforge.rb with the npm tarball version and SHA256, then publish that formula to a tap named smolforge:

npm view @smolai/forge dist.tarball
curl -L "$(npm view @smolai/forge dist.tarball)" -o smolforge.tgz
shasum -a 256 smolforge.tgz

Once the formula is in a tap:

brew install smolforge
sf --help