Storyden CLI

sd is Storyden's command-line client. It supports community content, administration, robots, and API discovery. Each saved context pairs a particular Storyden instance with a member or bot identity.

Build from sourceCopy Anchor Link

Clone the Storyden repository, use the Go version declared in its go.mod, and build the CLI from the repository root:

go install ./cmd/sd
sd --help

The CLI source and command reference describe the current command surface. A CLI built from a different Storyden revision can have a different API contract; build from a revision compatible with your instance when using newly added operations.

Connect to an instanceCopy Anchor Link

Use the community's web address. sd auth login starts a device authorization flow for an existing member when the instance has OAuth enabled:

sd auth login https://community.example
sd info --output json
sd page list --output json

An existing access key can also authenticate a script. Pass it through standard input so it is not exposed in shell history:

printf '%s' "$STORYDEN_ACCESS_KEY" | sd auth login https://community.example --access-key-stdin

For a separate bot identity, the operator must enable an autonomous registration policy. Where that policy allows it, supply the instance URL, a local context name with --name, and the requested bot handle with --handle:

sd auth register https://community.example \
  --name "Santaclaws' Little Helper" \
  --handle santaclaws-little-helper

Follow the approval or registration-token instructions supplied by the operator. Ordinary member login does not create a bot account.

Use sd api operations to find available REST operations and sd api schema OPERATION_ID to inspect an operation's request and response contract. Run sd --help or a subcommand's --help for the CLI version you built.