Can I use Celestial as a CLI?

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

Can I expose Celestial through MCP?

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

Where are Celestial credentials stored?

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

Can I deny write access for Celestial MCP tools?

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

data

Celestial CLI for Headless Automation

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

9 functions 9 read 0 write No credentials auth

Submit Celestial feedback View package source

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

Command Shape

# Celestial CLI for Headless Automation
kosmokrator integrations:configure celestial --enable --read allow --write ask --json
kosmo integrations:call celestial.celestial_moon_phase '{"date":"example_date","timezone":"example_timezone"}' --json

Discovery Before Execution

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

kosmo integrations:docs celestial --json
kosmo integrations:docs celestial.celestial_moon_phase --json
kosmo integrations:schema celestial.celestial_moon_phase --json
kosmo integrations:search "Celestial" --json
kosmo integrations:list --json

Useful Celestial CLI Functions

Function	Type	Parameters	Description
`celestial.celestial_moon_phase`	Read	date, timezone	Get current moon phase, illumination percentage, age, zodiac sign, and dates of next new/full moon.
`celestial.celestial_sun_info`	Read	latitude, longitude, date, timezone	Get sunrise/sunset times, solar altitude/azimuth, twilight phase, day length, and zodiac position for a location.
`celestial.celestial_moon_info`	Read	latitude, longitude, date, timezone	Get moon position, illumination, and visibility from a specific location.
`celestial.celestial_planet_position`	Read	latitude, longitude, planet, date, timezone	Get planet altitude/azimuth, zodiac position, and rise/set times. Set planet to "all" for an overview of all planets.
`celestial.celestial_solar_eclipse`	Read	date, latitude, longitude	Get solar eclipse data for a specific date and location — eclipse type, obscuration, contacts, and magnitude.
`celestial.celestial_lunar_eclipse`	Read	date	Get lunar eclipse data for a specific date — eclipse type, magnitude, gamma, contact times (P1-P4, U1-U4), and semi-durations.
`celestial.celestial_night_sky`	Read	latitude, longitude, timezone	Get what's visible in the night sky right now: sun/moon/planet positions, darkness level, and stargazing quality for a location.
`celestial.celestial_zodiac_report`	Read	date	Get all celestial bodies mapped to zodiac signs with alignments for a given date.
`celestial.celestial_time_info`	Read	date	Get astronomical time data — Julian Day, sidereal time (GMST/GAST), and equation of time.

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

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