Skip to content
Navigation

Command-line agent runner for the Orbiter framework.

python
from orbiter_cli import (
    # main — CLI entry point and config
    CLIError,
    app,
    find_config,
    load_config,
    resolve_config,
    # loader — agent discovery
    AgentLoadError,
    discover_agent_files,
    load_markdown_agent,
    load_python_agent,
    load_yaml_agents,
    scan_directory,
    validate_agent,
    # executor — local execution
    ExecutionResult,
    ExecutorError,
    LocalExecutor,
    # batch — batch processing
    BatchError,
    BatchItem,
    BatchResult,
    InputFormat,
    ItemResult,
    load_batch_items,
    results_to_csv,
    results_to_jsonl,
    # console — interactive REPL
    InteractiveConsole,
    format_agents_table,
    parse_command,
    # plugins — plugin system
    PluginError,
    PluginHook,
    PluginManager,
    PluginSpec,
)

Install: pip install "orbiter-cli @ git+https://github.com/Midsphere-AI/orbiter-ai.git#subdirectory=packages/orbiter-cli"


Submodules

ModuleDescription
orbiter_cli.mainCLI entry point, config discovery, Typer app
orbiter_cli.loaderAgent discovery and loading (Python, YAML, Markdown)
orbiter_cli.executorLocal agent execution with Rich output
orbiter_cli.batchBatch input loading and concurrent execution
orbiter_cli.consoleInteractive REPL console with slash commands
orbiter_cli.pluginsPlugin system with lifecycle hooks

Public API summary

ExportKindSource
CLIErrorExceptionmain
apptyper.Typermain
find_configFunctionmain
load_configFunctionmain
resolve_configFunctionmain
AgentLoadErrorExceptionloader
discover_agent_filesFunctionloader
load_markdown_agentFunctionloader
load_python_agentFunctionloader
load_yaml_agentsFunctionloader
scan_directoryFunctionloader
validate_agentFunctionloader
ExecutionResultClassexecutor
ExecutorErrorExceptionexecutor
LocalExecutorClassexecutor
BatchErrorExceptionbatch
BatchItemDataclassbatch
BatchResultDataclassbatch
InputFormatStrEnumbatch
ItemResultDataclassbatch
load_batch_itemsFunctionbatch
results_to_csvFunctionbatch
results_to_jsonlFunctionbatch
InteractiveConsoleClassconsole
format_agents_tableFunctionconsole
parse_commandFunctionconsole
PluginErrorExceptionplugins
PluginHookStrEnumplugins
PluginManagerClassplugins
PluginSpecClassplugins