Skip to main content
To keep things simple, we’ve provided a getting-started repository that contains a variety of sample schemas. Follow along with us by cloning the repository. 
git clone https://github.com/mirurobotics/getting-started.git
This guide focuses on the Mobility config type, which has two sample schema variations:
  • Empty schema - a schema that regards all config instances as valid
  • Strict schema - a well-defined schema that constrains the valid fields, types, and values for instances of the Mobility config type
Below are the empty and strict schemas defined in the getting-started repository.
x-miru-config-type: "mobility"
$schema: "http://json-schema.org/draft/2020-12/schema"
While we recommend using a strict schema, many teams find it simpler to start with an empty schema and gradually add constraints. This guide covers both variants, so feel free to follow along with either one.

​
Create a config type

Before defining a schema, we first need to create a config type to house it. Navigate to the config types page.
Click the New Config Type button. Supply the name Mobility and slug mobility. Finally, click Create.
Config type slugs are permanent and cannot be changed after creation.
The slug is a unique identifier for the config type—it’s how the CLI determines which config type a schema belongs to. As such, config schemas must be annotated with a config type slug. 
x-miru-config-type: "mobility"
The getting-started repository already annotates the Mobility schema with the mobility slug, so no need to add it yourself.

​
Set up the CLI

With Miru, config schemas can only be created via the CLI. This is a deliberate design choice—we believe schemas should live in a Git repository. This allows them to be versioned alongside the code that uses them and encourages better software development practices.

​
Install

To install the Miru CLI, run the installation command in your local machine’s terminal. 
curl -fsSL https://raw.githubusercontent.com/mirurobotics/cli/main/install.sh | sh
The script requires curl, tar, grep, and cut to be installed. Review the contents of the installation script here.
The Miru CLI supports macOS and Linux. Windows is not supported.

​
Login

To log in, run the login command. 
miru login
Retrieve your authentication token from the Secrets page.
You must be an admin user to retrieve an authentication token.
Paste the token into the CLI. 
Please retrieve your authentication token from the following URL:
🔗 https://app.mirurobotics.com/settings/cli-token

🔑 Paste your authentication token: **********

Validating authentication token...
✅ Successfully logged in as Benjamin

​
Push a schema

With the CLI setup, we are ready to push a schema to Miru. Navigate to the root of the getting-started repository and push the mobility schema to Miru. 
miru schema push ./jsonschema/empty-mobility.yaml
Upon a successful push, you’ll see a confirmation message similar to the following. 
🔍 Collected Git Metadata
    commit: b6e16a4baecb7631dc40663219832156be7eb08b
    origin: [email protected]:mirurobotics/getting-started.git
    file path: jsonschema/empty-mobility.yaml
    message: refactor: remove uneeded package imports & comments

🟢 mobility SCH-9Kd4W successfully created 
    language: jsonschema
    format: yaml
    created: Nov 30, 2025 at 10:15 AM PST
    instance file path: /mobility.json
Git metadata is pulled from the local Git repository that the schema is defined in.
To view the schema in Miru, navigate to the config types page and click into the Mobility config type.
Clicking into a specific schema will show the schema details, including its metadata and the schema content.