Can I use Beamer as a CLI?

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

Can I expose Beamer through MCP?

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

Where are Beamer credentials stored?

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

Can I deny write access for Beamer MCP tools?

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

marketing

Beamer CLI for Headless Automation

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

6 functions 5 read 1 write API key auth

Submit Beamer feedback View package source

Beamer 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 Beamer CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# Beamer CLI for Headless Automation
kosmokrator integrations:configure beamer --set api_key="$BEAMER_API_KEY" --enable --read allow --write ask --json
kosmo integrations:call beamer.beamer_list_posts '{"limit":1,"page":1,"status":"example_status"}' --json

Discovery Before Execution

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

kosmo integrations:docs beamer --json
kosmo integrations:docs beamer.beamer_list_posts --json
kosmo integrations:schema beamer.beamer_list_posts --json
kosmo integrations:search "Beamer" --json
kosmo integrations:list --json

Useful Beamer CLI Functions

Function	Type	Parameters	Description
`beamer.beamer_list_posts`	Read	limit, page, status	List changelog posts and announcements from Beamer. Supports pagination with limit and page, and filtering by status (published, draft, scheduled).
`beamer.beamer_get_post`	Read	id	Retrieve a single Beamer changelog post by its ID. Returns the full post including title, content, date, category, and metadata.
`beamer.beamer_create_post`	Write	title, content, category, date	Create a new changelog post or announcement in Beamer. Provide a title and content (HTML supported). Optionally set a category and scheduled publication date.
`beamer.beamer_list_comments`	Read	post_id	List all comments on a specific Beamer post. Returns comment text, author info, and timestamps.
`beamer.beamer_get_current_user`	Read	none	Get the profile of the currently authenticated Beamer user. Returns name, email, role, and account details. Useful for verifying credentials.
`beamer.beamer_list_categories`	Read	none	List all post categories in your Beamer account. Returns category IDs and names for use when creating or filtering posts.

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 Beamer CLI Pages

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