CLI
ox init
Initialize a repository with SageOx, connecting it to the platform and setting up local configuration.
Usage
terminal
$
Run this command from the root of your Git repository after authenticating with ox login.
What Happens During Init
When you run ox init, the CLI:
- Creates
.sageox/directory - Stores local configuration includingconfig.toml - Registers with SageOx - Links your repository to your SageOx account
- Scans repository structure - Analyzes your codebase conventions and patterns
- Configures defaults - Sets up sensible defaults based on detected project type
Flags
| Flag | Description |
|---|---|
--name | Override the repository name |
--team | Associate with a specific team |
-y, --yes | Skip confirmation prompts |
--force | Reinitialize even if already configured |
The .sageox/ Directory
.sageox/
├── config.toml # Repository configuration (committed)
└── config.local.toml # Local overrides (gitignored)Prerequisites
- Git repository with at least one commit
- Authenticated with
ox login - Write access to the repository root
Troubleshooting
"Not a git repository" - Run from within an initialized Git repository.
"Not authenticated" - Run ox login first.
"Repository already initialized" - Use --force to reinitialize.