Skip to content
CLI
Feed Channels

Feed Channels

Feed channels are where workflow outputs land so users can act on them in the platform’s Channels surface. The hutly channels group lets you list channels, create or archive them, and post an output into one. Commands run against the org resolved from your CLI config, so make sure you’re configured as the org that owns the workflow.

All commands emit machine-readable JSON by default. Pass --pretty for human-readable output, or --json (a no-op kept for compatibility).

hutly channels --help

list

List the org’s channels along with their ids, slugs, and which one is the default.

hutly channels list
hutly channels list --pretty

Each entry returns channelId, name, slug, and isDefault. Use the channelId to target a channel in archive or post.

create

Create a channel. Idempotent by name — creating a channel that already exists returns the existing one. Returns the channel id and slug.

hutly channels create "Lease Renewals"
hutly channels create "Lease Renewals" --emoji "📄"
Option Description
--emoji <emoji> Optional emoji shown beside the channel name.
--pretty Human-readable output.

archive

Archive a channel by its id. Its existing outputs stay visible under “All” — archiving only removes the channel from the active list.

hutly channels archive <channelId>
Option Description
--pretty Human-readable output.

post

Post an output into a channel. Omit both --channel and --channel-id to deliver to the org’s default channel (shown under “All”). Returns the new outputId and the channelId it landed in.

hutly channels post --title "Weekly summary" --body "## Done\n- 3 renewals processed"
hutly channels post --title "New listing" --channel "Listings" --type "Update"
hutly channels post --title "Reminder" --channel-id <channelId> --suggestion "Review the draft"

--title is required. Pass at most one of --channel / --channel-id; passing both is an error. Targeting --channel <name> creates that channel if it doesn’t already exist.

Option Description
--title <title> Required. Output title.
--body <markdown> Output body in markdown. Defaults to empty.
--channel <name> Target channel by name; created if it doesn’t exist.
--channel-id <id> Target channel by exact id.
--type <type> Output type badge. Defaults to Update.
--suggestion <text> A suggested next action shown under the output.
--pretty Human-readable output.