Skip to main content

Ossa Run

ossa run

Purpose: Run an OSSA agent locally

Synopsis

ossa run <manifest> [options]

Description

Run an OSSA agent locally

Arguments

  • <manifest> (required) - Path to agent manifest

Options

  • --env <file> - Environment variables file
  • --port <port> - Port to run on (default: 3000)
  • --watch - Watch for changes and reload
  • --debug - Enable debug logging

Examples

ossa run agent.ossa.yaml
ossa run agent.ossa.yaml --port 8080
ossa run agent.ossa.yaml --watch --debug
ossa run agent.ossa.yaml --env .env.local

API Endpoint Connection

This command uses the following API endpoint:

Exit Codes

  • 0 - Success
  • 1 - General error
  • 2 - Invalid arguments
  • 3 - File not found