CLI (agentkitforge)

The agentkitforge CLI ships with @agentkitforge/core — the same engine Forge uses in the browser — so every command behaves identically to its app counterpart. Use it in CI, pre-commit hooks, and scripts.

Install

npm install -g @agentkitforge/core
# the binary is: agentkitforge

Most commands operate on a kit folder (the directory containing agentkit.yaml). Market subcommands require sign-in via agentkitforge market login (headless-friendly device auth).

Local commands

# Validate (run before any share/export/submit)
agentkitforge validate <path> --profile publishable

# Inspect / summarize a folder as a kit
agentkitforge inspect <path>
agentkitforge summarize <path>

# Create a new kit (templates: blank, financial-review)
agentkitforge init <path> --template blank --id my-kit --name "My Kit"

# Package to a portable .agentkit.zip
agentkitforge package <path> --out dist/my-kit.agentkit.zip

# Export one-file Markdown (paste-ready; NOT re-importable)
agentkitforge export-onefile <path> --out dist/my-kit.onefile.md

# Build AI-ready context from a kit
agentkitforge build-context <path> --out context.md

Prepared prompts

agentkitforge list-prompts <path>
agentkitforge render-prompt <path> <prompt-id> --inputs key=value
agentkitforge validate-prompt-inputs <path> <prompt-id> --inputs key=value

Export to local agents

agentkitforge export-claude-code <path> --dest <dir>
agentkitforge export-codex <path> --dest <dir>

Versioning & drafts

agentkitforge version get|set|next <path> [version]
agentkitforge load-as-draft <path> --out draft.json
agentkitforge render-draft <draft.json> <dir>

Hosted Market

# Sign in / out (device auth — approve from any browser)
agentkitforge market login
agentkitforge market logout

# Submit for validation + admin review (no auto-publish)
agentkitforge market submit <path> --profile publishable

# Download & import a kit by slug, id, or URL (verifies sha256)
agentkitforge market import <slug-or-id-or-url>

# Paid kits: check entitlement / fetch a licensed package
agentkitforge market entitlement <slug-or-id-or-url>
agentkitforge market licensed-fetch <slug-or-id-or-url> --out kit.agentkit.zip

# Cloud favorites
agentkitforge market favorites list|add|remove

Tips

• Run validate --profile publishable before submitting to the Market.
• Use the CLI in CI to catch validation regressions before they reach the Market.
• Most commands expect the kit root — run them from where agentkit.yaml lives.
• export-onefile is not a package replacement; it cannot be re-imported as a kit.