Skip to main content

Cli Reference

CLI Reference

The OSSA CLI provides commands for managing AI agents throughout their lifecycle.

Installation

npm install -g @bluefly/openstandardagents

Quick Start

# Validate an agent manifest
ossa validate agent.ossa.yaml

# Generate a new agent
ossa generate worker --name "My Agent"

# Run an agent locally
ossa run agent.ossa.yaml

Commands

[object Object]

Validate OSSA agent manifests against the schema

[object Object]

Generate OSSA agent manifests from templates

[object Object]

Migrate agent manifests between OSSA versions

[object Object]

Run an OSSA agent locally

[object Object]

Initialize a new OSSA project

[object Object]

Set up OSSA development environment

[object Object]

Export agent manifest to different formats

[object Object]

Import agents from other frameworks

[object Object]

View and manage OSSA schemas

[object Object]

Manage GitLab agent integration

[object Object]

Manage OSSA agents

Global Options

  • --help - Show help for any command
  • --version - Show OSSA CLI version
  • --config <path> - Path to config file
  • --verbose - Enable verbose logging
  • --quiet - Suppress output

Configuration

The OSSA CLI can be configured via:

  1. Config file: .ossarc.json or .ossarc.yaml
  2. Environment variables: OSSA_*
  3. Command-line flags

Example .ossarc.json:

{
  "registry": "https://registry.ossa.dev",
  "defaultVersion": "0.2.8-RC",
  "validation": {
    "strict": true
  }
}

Environment Variables

  • OSSA_REGISTRY - Agent registry URL
  • OSSA_API_KEY - API authentication key
  • OSSA_VERSION - Default OSSA version
  • OSSA_DEBUG - Enable debug mode

Related Documentation