partiri CLI

The official command-line interface for Partiri Cloud. Deploy and manage services directly from your terminal.

Built in Rust.

Installation

Pre-built binary

Download the latest release from Codeberg Releases, extract, and add to your PATH.

Cargo (crates.io)

cargo install partiri-cli

npm

npm install -g @partiri/cli

Build from source

cargo build --release
# Binary at: target/release/partiri

Authentication

partiri auth

Stores your API key in ~/.config/partiri/key.

Environment variables:

Quick Start

# 1. Authenticate
partiri auth

# 2. Initialize config in your project directory
partiri init

# 3. Register the service on Partiri Cloud
partiri service create

# 4. Deploy
partiri service deploy

Adopt an existing service

If the service already exists on Partiri Cloud (created via the web frontend or by a teammate), skip init and create — pull is the only service subcommand that does not require a local .partiri.jsonc and will generate one for you:

# 1. Authenticate
partiri auth

# 2. In the project directory, pull the existing service
partiri service pull

You will be prompted to pick the workspace, project, and service; the CLI writes a ready-to-use .partiri.jsonc in the current directory.

Commands

Top-level

partiri service <subcommand>

partiri projects <subcommand>

partiri workspaces <subcommand>

partiri mcp <subcommand>

Install or remove the Partiri MCP server in AI tools. Valid --client slugs: claude-desktop, claude-code, cursor, vscode, copilot-cli, windsurf. Omit --client to pick interactively.

Config File — .partiri.jsonc

partiri init creates a .partiri.jsonc in your project root. The file uses JSON5 syntax (supports // comments and trailing commas).

{
  // Assigned by Partiri after running 'partiri service create'. Leave null until then.
  "id": null,

  "fk_workspace": "<uuid>",
  "fk_project": "<uuid>",

  "service": {
    "name": "my-service",

    // "webservice" | "static" | "private-service"
    "deploy_type": "webservice",

    // "node" | "rust" | "python" | "go" | "ruby" | "elixir" | "php" | "jvm" | "dotnet" | "cpp" | "static" | "registry"
    "runtime": "node",

    "root_path": ".",

    // Git repository source
    "repository_url": "https://github.com/org/repo",
    "repository_branch": "main",

    // Or registry image source (not compatible with deploy_type "static")
    // "registry_url": "registry.example.com",
    // "registry_repository_url": "myorg/myimage:latest",

    // Authentication token for private repos/registries — set via 'partiri service token'
    // "fk_service_secret": "<uuid>",

    "build_command": "npm run build",
    // "build_path": "dist",
    // "pre_deploy_command": "npm run migrate",
    "run_command": "npm start",

    "fk_region": "<region-uuid>",
    "fk_pod": "<pod-uuid>",

    "health_check_path": "/health",

    "maintenance_mode": false,
    "active": true,

    // Environment variables injected at runtime
    "env": [
      { "key": "NODE_ENV", "value": "production" }
    ]
  }
}

Field reference

Project Detection

partiri init auto-detects your project type and pre-fills defaults:

It also reads the git origin remote to pre-fill repository_url, and imports variables from a local .env file (if present) into service.env.

Typical Workflow

your-project/
├── .partiri.jsonc   ← managed by the CLI
├── src/
└── ...

# First time
partiri auth                 # save API key
partiri init                 # interactive wizard → .partiri.jsonc
partiri service create       # register on Partiri → writes id to config
partiri service deploy       # trigger first deploy

# Ongoing
partiri service push         # push local config changes (env vars, commands, etc.)
partiri service deploy       # redeploy
partiri service metrics      # check live state
partiri service jobs         # review deploy history

# Maintenance
partiri service pause        # pause the service
partiri service unpause      # resume
partiri service kill         # permanently stop (with confirmation prompt)

Development

# Run from source
cargo run -- <command>

# Example
cargo run -- service metrics

Requires Rust 1.77+ (edition 2021). No system OpenSSL dependency — TLS is handled by rustls.