xo-bosun Package¶

xo-bosun is the monorepo management CLI for the XO-Data platform. It provides seamless navigation between packages, environments, and deployment targets.

Purpose¶

Working in a monorepo means frequently navigating between deeply nested directories. xo-bosun provides the xo command for instant navigation with tab completion.

Installation¶

# Install xo-bosun package
uv sync --package xo-bosun

# Set up shell integration (generates and installs shell function)
uv run xo setup --auto

# Or generate manually and add to your shell profile
uv run xo setup

Commands¶

`xo cd [target]`¶

Navigate to a specific target or the repo root.

# Go to repo root
xo cd

# Go to a package
xo cd xo-foundry
xo cd xo-core

# Go to a deployment
xo cd astronomer
xo cd snowflake-schema

# Go to a development environment
xo cd data-engineering-dev

`xo list [--category]`¶

List available navigation targets.

# List all targets
xo list

# List by category
xo list --category packages
xo list --category environments
xo list --category deployments

`xo setup [--auto]`¶

Generate shell integration for the xo cd function.

# Auto-detect shell and install
xo setup --auto

# Print shell function (add to .bashrc/.zshrc manually)
xo setup

`xo completion [--install]`¶

Generate and install tab completion.

# Install tab completion for your shell
xo completion --install

# Print completion script
xo completion

Available Targets¶

Category	Target	Directory
Packages	`xo-bosun`	`packages/xo-bosun/`
	`xo-foundry`	`packages/xo-foundry/`
	`xo-core`	`packages/xo-core/`
	`xo-lens`	`packages/xo-lens/`
Environments	`data-engineering-dev`	`development/data-engineering-dev/`
	`astronomer-dev`	`development/astronomer-dev/`
	`lens-dev`	`development/lens-dev/`
Deployments	`astronomer`	`apps/airflow/xo-pipelines/`
	`snowflake-schema`	`apps/snowflake-schema/`

Shell Integration¶

xo-bosun requires a shell function (not just a binary) because cd must run in the parent shell process. The xo setup command generates the appropriate function for your shell (bash, zsh, fish, PowerShell).

Dependencies¶

typer -- CLI framework
Cross-platform (macOS, Linux, Windows)

Package Location: packages/xo-bosun/