Open Orchestrator

Appearance

The config command group provides tools for validating and inspecting your Open Orchestrator configuration. Use it to catch configuration errors early or see the effective settings after merging all config sources.

Subcommands ​

SubcommandDescription
owt config validateValidate configuration against the schema
owt config showDisplay effective configuration as TOML

owt config validate ​

Validates your .worktreerc or other config file against the Pydantic schema. Reports errors for invalid keys, wrong types, or missing required values.

Usage ​

bash
owt config validate

Examples ​

bash
# Validate the current project config
owt config validate

Output (valid):

Configuration is valid.

Output (errors):

Configuration errors:
  - [tmux] ai_tool: 'invalid-tool' is not a valid option (claude, pi, opencode, droid)
  - [worktree] auto_cleanup_days: expected int, got string

owt config show ​

Displays the effective configuration after merging all config sources (project .worktreerc, user config, defaults). Output is valid TOML that you can redirect to a file.

Usage ​

bash
owt config show

Examples ​

bash
# See effective configuration
owt config show

Output:

toml
[worktree]
base_directory = "../"
auto_cleanup_days = 14
naming_pattern = "{project}-{branch}"

[tmux]
auto_start_ai = true
ai_tool = "claude"
session_prefix = "owt"
mouse_mode = false
prefix_key = "C-b"

[environment]
auto_install_deps = true
copy_env_file = true
adjust_env_paths = true
additional_config_files = []

[sync]
default_strategy = "merge"
auto_stash = true
prune_remote = true
bash
# Save effective config to a file
owt config show > my-config.toml

Use Cases ​

Debugging Configuration Issues ​

bash
# Check if config is valid
owt config validate

# See what settings are actually being used
owt config show

Sharing Team Configuration ​

bash
# Export effective config for the team
owt config show > .worktreerc

See Also ​