Can I use Bluesky as a CLI?

Yes. KosmoKrator exposes a Bluesky CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Bluesky through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Bluesky tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Bluesky credentials stored?

Bluesky credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Bluesky MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

social

Bluesky CLI for Headless Automation

Use the Bluesky CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.

6 functions 5 read 1 write Manual OAuth token auth

Submit Bluesky feedback View package source

Bluesky CLI for Headless Automation

Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.

Use headless automation when another tool needs a stable local command surface. The Bluesky CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# Bluesky CLI for Headless Automation
kosmokrator integrations:configure bluesky --set access_token="$BLUESKY_ACCESS_TOKEN" --set did="$BLUESKY_DID" --enable --read allow --write ask --json
kosmo integrations:call bluesky.bluesky_create_post '{"text":"example_text","langs":"example_langs","facets":"example_facets","createdAt":"example_createdAt"}' --json

Discovery Before Execution

Agents and scripts can inspect Bluesky docs and schemas before choosing a function.

kosmo integrations:docs bluesky --json
kosmo integrations:docs bluesky.bluesky_create_post --json
kosmo integrations:schema bluesky.bluesky_create_post --json
kosmo integrations:search "Bluesky" --json
kosmo integrations:list --json

Useful Bluesky CLI Functions

Function	Type	Parameters	Description
`bluesky.bluesky_create_post`	Write	text, langs, facets, createdAt	Create a new post on Bluesky. The post text is required and supports facets (mentions, links, tags) if provided.
`bluesky.bluesky_get_profile`	Read	actor	Get the public profile of a Bluesky user. Provide a handle (e.g. "alice.bsky.social") or DID.
`bluesky.bluesky_list_followers`	Read	actor, limit, cursor	List the followers of a Bluesky account. Returns follower profiles with handles, display names, and avatars.
`bluesky.bluesky_list_following`	Read	actor, limit, cursor	List the accounts that a Bluesky user follows. Returns profiles with handles, display names, and avatars.
`bluesky.bluesky_search_posts`	Read	q, limit, cursor	Search for posts on Bluesky. Supports full-text search queries. Returns matching posts with author, text, and timestamps.
`bluesky.bluesky_get_current_user`	Read	none	Get the authenticated user's own Bluesky profile. No parameters required — uses the configured account.

Automation Notes

Use --json for machine-readable output.
Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
Configure read/write policy before unattended runs; use --force only for trusted automation.
Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.

Related Bluesky CLI Pages

CI Bluesky CLI for CI. Cron Jobs Bluesky CLI for cron jobs. Shell Scripts Bluesky CLI for shell scripts. Coding Agents Bluesky CLI for coding agents.