Skip to main content

​
Agent Quickstart

This guide walks you through running a simulated satellite execution using the RotaStellar Operator Agent.

​
Prerequisites

​
1. Clone and Build

The binary is at target/release/rotastellar-agent.

​
2. Create a Plan

Before running the agent, you need a deployment. In Mission Control:
  1. Go to Missions and create a new mission
  2. Open the mission and click New Plan
  3. Select a satellite (e.g., ISS — NORAD ID 25544) and a preset (e.g., On-Board ML Inference)
  4. Review the plan and click Deploy
  5. Choose Live mode — this creates a deployment that waits for an agent
Alternatively, create a plan via the CAE API and save the response:

​
3. Run the Agent

Run the agent in long-running poll mode. It will register with the Console, then continuously poll for pending deployments.
When you deploy a plan in Mission Control with Live mode, the agent will pick it up automatically.

​
Option B: Simulate a plan file

If you have a saved CAE plan JSON, you can replay it directly:

​
4. Watch the Execution

Open the deployment in Mission Control. You’ll see events appear in the timeline as the agent reports them:
The deployment status transitions: pending → dispatched → running → completed.

​
5. Check Telemetry

While running, the agent sends periodic telemetry heartbeats. You can see agent status in the Console under Agents — including status, last heartbeat, and resource usage.

​
What’s Next

Protocol Spec

Deep dive into the pull-based protocol

Rust SDK

Build a custom agent for your satellite hardware