open-index/open-npm huggingface dataset:
npm package: @jerrylin-sga/km
Description: Machine CLI for SGA-KM HTTP surfaces
Author: SGA
Latest version: 0.1.0

# `@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

```bash
npm install @jerrylin-sga/km
```

Or from a local checkout:

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

Run without installing globally:

```bash
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:

```bash
sga-km --help
```

## Commands

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