Pretty-print kerboscript: uppercase keywords, 2-space indent, } on its own line, statements terminated with ., and strings/comments preserved. The formatter is idempotent.

Run the kerboscript static linter against an in-memory snippet. Returns a list of diagnostics with stable error codes (unbalanced_brace, missing_period, unterminated_string, undeclared_variable, cooked_steering_trigger, etc).

Read a file from the archive volume (or any local path) and lint it. Useful before re-uploading a recently edited script.

Stop a background task by setting its _BG_<name>_RUN flag to FALSE. The dormant trigger remains parked until the program ends.

Stop every background task. Same kerboscript caveat as kos_bg_kill. Returns ok=true even when a per-task kill failed; check failures for the names.

List every background task known to this MCP instance.

Install a kerboscript code block as a background trigger. The block is wrapped in WHEN _BG_<name>_RUN AND (<run_until>) THEN { <code>. PRESERVE. }. WARNING: kOS interrupts the mainline to run the trigger; do NOT WAIT inside code and keep the body short or the rest of the program will starve.

List SHIP:CREW() with name, trait, experience, gender, tourist flag.

Total ship delta-V plus per-stage delta-V and effective vacuum ISP (averaged across that stage's active engines).

List engines (LIST ENGINES IN _E) and report thrust, ISPs, fuel flow, ignition / flameout / throttle-lock state.

Print SHIP:MASS / SHIP:DRYMASS / SHIP:WETMASS (in metric tonnes), with derived fuel = mass - dry.

List parts on the current vessel. Capped at 80 rows; pass a filter to narrow down. Optionally groups results by module/stage/tag on the MCP side.

Snapshot of STAGE:RESOURCES (current stage) and SHIP:RESOURCES (whole vessel).

Current stage number, total stage count, plus delta-V (current/vac/asl/duration) for every stage from current down to 0.

Find every part whose nametag matches tag exactly. Returns {exists, count, parts}.

Compact card: name + one-line summary + first example.

Return a global function definition (eg ABS, ROUND).

Return a kerboscript keyword/command definition (eg RUN, LOCK, WAIT).

Return a method definition. Provide parent to disambiguate (Vessel:STAGEDELTAV).

Return a full structure with its attributes, methods, and inherited siblings.

Return the full markdown of a topic (file-level entry) given its slug, eg general/telnet.

Inspect the docs index: whether it's loaded, build_time, model, entry counts.

List code-block examples. Filter by topic slug or owning structure name.

Trigger a fresh index build in a detached child process. Returns immediately; first build downloads the MiniLM model (~30 MB), expect 1-3 minutes.

Related entries: union of :see also: cross-references and same-section siblings.

Hybrid kOS docs search. mode='hybrid' (default) does BM25 recall (top 30) then semantic rerank with all-MiniLM-L6-v2; mode='lex' is BM25 only; mode='sem' is pure cosine. Set category to filter by entry kind.

Reverse-resolve a kerboscript symbol at the given (line, col) cursor position. Walks suffix chains like SHIP:ORBIT:APOAPSIS.

Delete a knowledge-base topic (markdown file + index entry). Idempotent: returns removed:false when the topic was not present.

List knowledge-base entries from the index, optionally filtered by tag and capped by limit. Sorted newest-updated first.

Read a knowledge-base topic. Returns the markdown body plus its index metadata.

Plain regex grep over every knowledge-base entry. Returns one row per matching line.

Write or update a knowledge-base topic. Stored as <archive>/kb/<topic>.md plus an index entry. Topic must match [a-zA-Z0-9_-]+, max 60 chars.

Return the name of the currently active vessel (KUNIVERSE:ACTIVEVESSEL:NAME).

Snapshot CANREVERT, CANREVERTTOLAUNCH and CANREVERTTOEDITOR in a single round-trip. Use this before offering revert as an option to the user / planner.

Append a line to the Unity Player.log via KUNIVERSE:DEBUGLOG. Pairs naturally with ksp_log_tail for cross-stack tracing - drop a marker before/after a tricky operation and grep the log for it.

Switch the active vessel even when KSP would normally refuse (e.g. atmospheric flight, under acceleration). NOTE: KSP may treat the previous vessel as if it were re-entering the atmosphere, which can delete it. Prefer the safer non-force vessel switch via SET KUNIVERSE:ACTIVEVESSEL TO ... when conditions allow.

Call KUNIVERSE:PAUSE() to bring up the in-game escape menu. ⚠ DESTRUCTIVE TO AGENT FLOW: kOS execution halts entirely while paused; the agent CANNOT issue further commands until a human clicks 'Resume' (Ctrl-C through kos_session_interrupt also works). Use sparingly.

Trigger KSP's quickload (revert to a prior quicksave). With name, uses QUICKLOADFROM. WARNING: a successful load tears down the current scene; expect the telnet session to drop and the agent to need to reconnect / re-attach.

Trigger KSP's quicksave. With name, calls QUICKSAVETO; otherwise QUICKSAVE. Refuses to act when KUNIVERSE:CANQUICKSAVE is false (e.g. quicksaves disabled in difficulty options, or the active scene does not support saving).

Enumerate all quicksave files in the current game (KUNIVERSE:QUICKSAVELIST). Uses a delimited FOR loop instead of LIST:TOSTRING so parsing is robust across kOS versions.

Revert to the editor (VAB or SPH per the vessel's origin) via KUNIVERSE:REVERTTOEDITOR. Refuses when KUNIVERSE:CANREVERTTOEDITOR is false (typically true after loading a saved game).

Revert the active vessel to the launch pad / runway via KUNIVERSE:REVERTTOLAUNCH. Refuses when KUNIVERSE:CANREVERTTOLAUNCH is false (e.g. the revert window has expired or the vessel was loaded from a save). Like quickload, expect the telnet session to drop on success.

Add a maneuver node via ADD NODE(time, radial, normal, prograde). Provide either eta (seconds from now) or time (UT seconds).

Remove every node from the flight plan with a portable UNTIL NOT HASNODE { REMOVE NEXTNODE. } loop.

Upload the standard execute-node template (0:/inspect/execute_node.ks) and RUN it detached. Poll completion via kos_session_wait_for "BURN_COMPLETE:". The agent retains control of the session while the burn runs.

List every node on the active vessel's flight plan (in chronological order).

Remove one node by index (0-based). Omitting index removes NEXTNODE.

Run COMPILE [TO ]. Returns the resolved destination path.

Delete a file or directory via DELETEPATH(...).

Print capacity and free space for every visible volume.

Evaluate a single kerboscript expression with PRINT (...) and return the printed value.

Run LIST FILES IN <vol>. and return the parsed table.

Print the MODE of every kOSProcessor on the active vessel.

Read a kerboscript file. For paths on the archive volume we read directly from disk; for local kOS disks we route through telnet.

RUNPATH a saved script. detached=true returns immediately; otherwise we wait for the prompt.

Send Ctrl-C to break the currently running script.

Upload a kerboscript file to a kOS volume. Picks fs vs telnet automatically.

Reset the data CSV by writing {clear:true} into cmd.json. The boot loop deletes data.csv, recreates it with the header, and acks by overwriting cmd.json with {state:'running'}.

Return the full recorder data set in csv / json / ndjson form.

Generate a recorder boot script for the given channels, deploy it onto a recorder kOSProcessor, activate it, and wait until the recorder writes its READY status.

List every recorder session known to this MCP instance (in-memory plus archive index).

Inspect the live status of a recorder session: state (starting/running/stopped/error), frame count, latest_t, data_bytes.

Mark the recorder for graceful shutdown by writing {stop:true} into cmd.json. The boot loop polls cmd.json once per second.

Read recorder rows newer than since_t. Reads the CSV directly from the archive disk (does not occupy telnet).

Stop the recorder, clear BOOTFILENAME on the recorder CPU, delete the archive directory, and forget the session.

Send statements directly to the active CPU's interpreter. Unlike kos_program_eval, GLOBAL state survives between calls. Multi-line input is split on \n and each line is sent + flushed individually via the completion sentinel; multi-line BLOCK statements (e.g. an open IF { ... } spanning physical lines) are NOT supported.

List the variable names this MCP instance has touched via kos_repl_set. kOS exposes no introspection over the GLOBAL scope, so this is a hint set, NOT the authoritative list of every GLOBAL on the CPU.

PRINT a single name and return the displayed value. Equivalent to kos_program_eval(name) but limited to a bare identifier.

Issue REBOOT. on the active CPU. WARNING: this restarts the kOS interpreter, killing every LOCK, GLOBAL, WHEN/ON trigger and the running program. Watch and bg registries on the MCP side are NOT cleared automatically; the dormant entries become orphans pointing at no-longer-existent kOS state. (Spec calls this RESET.; kOS uses REBOOT..)

Send SET <name> TO (<expr>). and remember name so kos_repl_get_globals can list it.

Render a bundled mission template into a kerboscript snippet. Defaults from the template's schema fill in any params you omit.

List the bundled mission templates with their descriptions, parameter schemas, and operational notes.

Drop everything currently in the in-memory rolling history buffer.

Attach to a CPU by 1-based menu index, then wait for the kOS attach banner (kOS 1.5+ never emits a kOS> prompt; success is signalled by the boot banner ending in Proceed.).

Send Ctrl-D to leave the current CPU and return to the welcome menu.

Send Ctrl-C (telnet IP) to break the running kOS program. Same as send_keys with CTRL_C.

List the CPUs visible from the kOS welcome menu. Triggers a redraw on the first call so the menu is always fresh.

Return entries from the rolling history buffer, optionally filtered by timestamp / regex / size.

Return the current 80x24 (or configured) terminal frame plus cursor coords.

Send literal text to the active CPU (or the menu). Optionally append ENTER. Does NOT wait for a prompt.

Send one or more named special keys, in order. Useful for Ctrl-C / arrows / Home / End / etc.

Look at the current screen and reconcile session.mode (menu vs attached) with what kOS is actually showing. Use this if connect() returned attach_timeout but you suspect attach actually succeeded - or after a manual Ctrl-D / detach you want to re-detect. Returns the corrected state.

Block until a regex matches the screen text, or a timeout elapses.

Convenience wrapper that runs every snapshot.* tool sequentially and returns one merged object. Warning: this returns a relatively large payload; prefer the individual snapshots when you only need part of the picture.

Pitch / yaw / roll from SHIP:FACING, the up-vector, angle-of-attack, vertical/ground/airspeed, and current TWR.

Body summary (radius, MU, atmosphere height, rotation period). When name is omitted, returns the SOI body.

Per-resource snapshot for LIQUIDFUEL, OXIDIZER, MONOPROPELLANT, ELECTRICCHARGE, SOLIDFUEL, XENONGAS. Returns ship-wide and current-stage amounts.

Single-prompt snapshot of orbit: APOAPSIS, PERIAPSIS, SEMIMAJORAXIS, INCLINATION, ECCENTRICITY, PERIOD, BODY:NAME, ETA:APOAPSIS, ETA:PERIAPSIS.

Altitude, radar altitude, latitude, longitude, vertical/ground speed, and an approximate terrain slope.

Target state. Returns present:false when nothing is targeted; otherwise distance, relative velocity, and ETA-to-closest-approach (negative if moving away).

List the hottest parts (by current temperature / max temperature ratio). Defaults to the top 5.

Throttle, steering string, wheel-steering, RCS, SAS, gear, brakes, lights.

Cancel any active warp - both WARPTO and manual rate changes (KUNIVERSE:TIMEWARP:CANCELWARP).

Set TIMEWARP:MODE to PHYSICS or RAILS. PHYSICS warp keeps the simulation running and is required during atmospheric flight or under thrust; RAILS warp is the fast on-rails warp used between burns.

Set time warp by target rate. Reads RATELIST for the current MODE, picks the closest legal entry, and SETs WARP to its index. Returns both the requested rate and the actually applied rate so the agent can compensate for snap-to-list quantisation.

Set the WARP integer index directly (0,1,2,...). Use this when you already know the index you want; the corresponding multiplier depends on MODE and RATELIST.

Snapshot of TIMEWARP state in one round-trip: rate (current effective multiplier), warp_index, mode, is_settled (true once the live rate has caught up with the commanded one), and current_time (TIME:SECONDS).

Poll KUNIVERSE:TIMEWARP:ISSETTLED until true or the timeout elapses. Use after kos_timewarp_set / set_index / warp_to so subsequent reads reflect the final rate rather than the in-progress ramp.

WARPTO a universal timestamp. Pass an absolute UT in seconds (compute from TIME:SECONDS via kos_timewarp_status if you only have a delta). Optionally switches MODE first.

Register a periodic kerboscript expression. The MCP injects a WHEN ... THEN { PRINT ... PRESERVE. } trigger that prints [W:<id>:<label>] <value> every 1/hz seconds. The expression is NOT sandboxed - the agent is responsible for not breaking the host script.

Mute every registered watch. Same kerboscript caveat as kos_watch_remove. Returns ok=true even when a per-watch mute failed; check failures for the ids.

List every watch known to this MCP instance.

Pull tagged watch lines out of the rolling telnet history. ts_ms is the time the line arrived over telnet, NOT the in-game time.

Mute a watch by setting its _W_<id>_RUN flag to FALSE. The trigger itself remains parked on the kOS CPU until the program ends - kerboscript has no syntax to retire a PRESERVE'd trigger early. See known_issues.

Set an in-memory marker at the current Player.log byte offset. Subsequent calls to ksp_log_since_marker only return text written after this point.

Grep Player.log for a regex pattern. Reads up to max_kb of the tail (default 1024 KB) to avoid memory blow-up; truncated becomes true when the cap is hit.

Inspect the in-memory marker (byte offset, set timestamp). Useful for debugging when log_since_marker returns less than expected.

Return the platform-specific Player.log path used by KSP (Unity). Includes existence + size info so the agent can decide whether it's worth tailing.

Return everything written to Player.log since the last ksp_log_clear_marker call. If no marker has been set yet, behaves as if the marker were placed at the current EOF.

Read the tail of Player.log (default: last 64 KB, last 100 lines). Optional filter by level / source regex / message regex.