TERMINAL / AGENT RUNTIME

ORCA CLI

MINECRAFT WORK,
FROM YOUR TERMINAL

Inspect instances, build assets, launch Minecraft, and manage owned servers through one command surface for humans and coding agents.

orcaclient.com/minecraft-cli
ORCA WORKSPACECONNECTED
planner.tsplanner agent
01function buildBase(area) {
02 const planner = new Planner()
03 const layout = planner.planBase(area)
04 for (const step of layout) {
05 await builder.place(step)
06 }
07 return verify(area)
08}
agent: Plannerready
TERMINALLIVE

$ orca init my-world

Initializing Minecraft project[✓] Scaffolding project...[✓] Configuring agents...Project ready.

$ orca agent build --task "build base"

Agent Orca-1.2[✓] Planning[✓] ExecutingTask complete.

$ orca run

Starting world...World running on port 25565

$

A blocky green dinosaur agent walking through the Orca CLI workspace

Run the interface before you install it

Select a workflow, inspect its command, and run a safe simulation of the response your terminal or coding agent receives.

workflows05
terminalbash · interactive
$orca commands

[✓] Loaded 42 available actions

minecraft · instances · assets · servers

Run any command with --help for its contract

SANDBOX READY
MADE WITH ORCA CLI

See what you can ask Orca to make and do

The CLI and MCP are two surfaces for the same creation and server tools. Open any card for the exact workflow and a working example.

Builder Hammer Minecraft itemBUILDER HAMMERmade through CLI
ASSETS

Minecraft item maker

Builder Hammer and Shark-Tooth Dagger

orca asset create --project-id demo --kind item --name shark_tooth_dagger --description "shark-tooth dagger"Open capability page
ORCA BLOCKdrag-free 3D preview
ASSETS

Minecraft block maker

Orca Block and Happiness Ore

orca asset create --project-id demo --kind block --name happiness_ore --description "softly glowing happiness ore"Open capability page
STORM WIZARD64×64 generated skin
ASSETS

Minecraft skin generator

Wizard and Samurai skins

orca tool run generate_skin --name storm_wizard --description "storm wizard with a teal cloak"Open capability page
Orca Minecraft T-rex model
ASSETS

Minecraft mob maker

Retexture, custom build, or AI-to-Blockbench

orca tool run generate_model --name village_trex --description "friendly village guardian T-rex"Open capability page

Built for humans and coding agents

Friendly noun-and-verb commands make common Minecraft workflows readable, scriptable, and easy to inspect before execution.

01

Discover commands

Run orca commands or orca actions to inspect supported capabilities instead of guessing command names.

02

Inspect Minecraft instances

List local instances and their installed mods using structured output suitable for scripts and agents.

03

Install and launch

Install a creation into a selected instance, resolve the launch, then start the matching Minecraft setup.

04

Create Minecraft assets

Generate item, block, GUI, texture, model, and skin assets for an Orca project.

05

Manage owned servers

Inspect status, logs, players, files, mods, settings, and power actions through owner-scoped server commands.

06

Return structured JSON

Use machine-readable results so a coding agent can verify state and continue a multi-step workflow.

Inspect, preview, then execute

The CLI separates discovery from consequential actions so automation stays predictable.

  1. 01

    Discover the command

    Use orca commands, orca actions, and orca doctor to understand the available local and cloud surfaces.

  2. 02

    Select the exact target

    Name the Minecraft instance or server explicitly. Read-only commands return current state without changing it.

  3. 03

    Preview and confirm

    Use dry-run when available, then confirm the exact consequential action after reviewing its target and arguments.

Automation with clear boundaries

The CLI never stores Orca service credentials. Local actions pass through a private desktop handoff; cloud and server actions use authenticated, owner-scoped hosts.

orca.permissionsverified
  • Explicit instance and server selectors
  • Dry-run support before consequential actions
  • Single-use authorization for protected server changes
  • No raw access to service credentials
scopeleast-privilege

Common questions

Everything you need before opening a terminal.

01 / How do I install the Orca CLI?

Install Orca Desktop, which installs and updates the matching command-line tool. The CLI is currently distributed with Orca rather than as a standalone npm package.

02 / Does the Orca CLI control terminal panels or IDE tabs?

No. Orca CLI controls Orca and Minecraft capabilities. Your terminal, IDE, or workspace tool remains responsible for its own panes, tabs, and window layout.

03 / Can a coding agent use the Orca CLI?

Yes. The CLI exposes discoverable commands and structured JSON output so terminal-based agents can inspect capabilities, propose actions, and verify results.

04 / Are CLI and MCP separate implementations?

They are two interfaces over the same canonical capability contracts. This keeps command names, schemas, permission requirements, and core behavior aligned.