@jerrylin-sga/km

Machine CLI for sga-km HTTP surfaces.

Goals

• JSON-first
• non-interactive
• stable exit codes
• thin wrapper over sga-km HTTP atomic capabilities
• suitable for SGA-Molt and Claw invocation

Install

npm install @jerrylin-sga/km

Or from a local checkout:

npm install ./sdk/npm/sga-km-cli

Run without installing globally:

node ./sdk/npm/sga-km-cli/bin/sga-km.js manifest

Environment

• SGA_KM_BASE_URL
• SGA_KM_API_KEY
• SGA_KM_TIMEOUT optional, milliseconds

You can also pass:

• --base-url
• --api-key
• --timeout

Show command summary:

sga-km --help

Commands

sga-km manifest
sga-km opencli
sga-km health
sga-km capabilities

sga-km memory put --content "..." --space-id space-1
sga-km memory search --query "..." --space-id space-1
sga-km memory recent --space-id space-1 --limit 10
sga-km memory update --item-id item-1 --content "..."
sga-km memory archive --item-id item-1
sga-km memory restore --item-id item-1
sga-km memory delete --item-id item-1

sga-km knowledge search --query "..." --kb-id kb-1 --include-answer

sga-km documents add --kb-id kb-1 --file ./report.pdf
sga-km documents add --kb-id kb-1 --url https://example.com/file.pdf
sga-km documents replace --kb-id kb-1 --document-id doc-1 --file ./new.pdf
sga-km documents delete --kb-id kb-1 --document-id doc-1
sga-km documents parse-status --job-id job-1
sga-km documents retry --job-id job-1 --selected-parser-id deepdoc

sga-km graph build --kb-id kb-1 --document-id doc-1
sga-km graph rebuild --kb-id kb-1 --exclude-document-id doc-2
sga-km graph reconcile --kb-id kb-1
sga-km graph prune-document --kb-id kb-1 --document-id doc-1

Notes

• stdout always prints JSON
• stderr prints error summaries
• successful commands return exit code 0
• command or API failures return exit code 1
• help returns exit code 0

Packaging recommendation

For SGA-Molt:

• use HTTP directly for hardcoded capability implantation
• use this CLI for Claw autonomous actions
• if needed, wrap this package again as an OpenClaw plugin tool layer