Quickstart

Run commands from a library

No account needed — install a library and start running commands immediately.

Install a library
Terminal window
```
my library install kubernetes
```
Run a command

Library commands are available as top-level subcommands:
Terminal window
```
my kubernetes port-forward svc/my-service -p 8080
```

Discover commands

my library list              # List installed libraries
my library explore           # Browse libraries interactively
my kubernetes --help         # See commands in a library

Create your own commands

Log in

mycli uses email-based magic links for authentication:
Terminal window
```
my cli login
```
Enter your email address and click the verification link sent to your inbox. After verification, the CLI stores your credentials securely in the OS keyring.

Create a command

Scaffold a new command spec:

my cli init hello

This creates a hello/command.yaml file with a starter template. Edit it:

schemaVersion: 1
kind: command

metadata:
  name: hello
  slug: hello
  description: Say hello

args:
  positional:
    - name: name
      description: Who to greet
      required: true

steps:
  - name: greet
    run:
      - echo "Hello, {{.args.name}}!"

Push to the registry
Terminal window
```
my cli push -f hello/command.yaml
```
The CLI validates your spec against the JSON Schema and publishes it to the server.
Run
Terminal window
```
my cli run hello -- World
```
Output:
```
Hello, World!
```

Next steps

Libraries Install, discover, and manage command libraries.

Creating Commands Learn the full spec format for authoring commands.

Template Variables Use dynamic values in your commands.