@sys9/inbox9-cli

@sys9/inbox9-cli installs the inbox9 command.

The installed inbox9 executable is a bundled native binary. Node.js is not required at runtime.

Install

npm install -g @sys9/inbox9-cli
# or
bun add -g @sys9/inbox9-cli

Quickstart

All messaging operations are scoped by a required space_id. Identifiers support 3-512 characters and match ^[0-9A-Za-z_][0-9A-Za-z_\\-/.]{2,511}$.

inbox9 set space team.alpha/sp_01

inbox9 set sender_id user/alice
inbox9 send user/bob --payload '{"kind":"direct","text":"hello"}'

inbox9 read user/bob
inbox9 mark-read user/bob <msg_seq>
# or
inbox9 mark-read user/bob <msg_seq> --type discard

set space only selects the default space_id; the first send or space update can implicitly create an open space. Use space create --id <space_id> only when you want to provision/check that space up front, or add --secret during creation. Omit --id on space create if you want the server to generate an opaque space_id. The CLI and Go SDK URL path escape slash-bearing identifiers automatically; raw HTTP callers must escape them explicitly.

If inbox9 send ends with a transport error or temporary HTTP response, rerun the same visible command. The CLI keeps send retry state locally so ordinary usage does not expose transport-key flags.

Supported platforms

• Linux x64, arm64
• macOS x64, arm64

Release contract

• npm package version X.Y.Z bundles prebuilt inbox9 binaries for all supported platforms
• those binaries are staged under vendor/<goos>_<goarch>/inbox9
• npm pack / npm publish fail unless vendor/ contains one non-empty executable bundled binary file for every supported platform
• GitHub release tag vX.Y.Z-inbox9-cli publishes matching standalone binaries
• the tag release workflow requires the npm package to trust sys9-ai/bricks + .github/workflows/inbox9-release.yml as a trusted publisher before the tag is pushed
• if that package-side trust is repaired after a failed tag release, rerun the same vX.Y.Z-inbox9-cli workflow run; it reuses the existing GitHub release and still derives the npm publish version from the tag
• the installed executable name is inbox9