Skip to main content

​
What Is a Workspace?

An Osmosis workspace is the platform space where your team manages datasets, training runs, models, deployments, members, and one connected GitHub repository. The connected GitHub repository is the workspace repository. Your local clone is the workspace directory.
TermMeaning
Platform workspaceThe team space in the Osmosis Platform.
Workspace repositoryThe GitHub repository connected to that platform workspace.
Workspace directoryYour local clone of the workspace repository.

​
Getting Started

Start with Onboarding to create or join a platform workspace, connect GitHub, clone the workspace repository, and authenticate the CLI. After onboarding, your local workspace directory contains the standard workspace structure: 
repository/
├── rollouts/            # AgentWorkflow + Grader code
├── configs/             # Training and evaluation configs
├── data/                # Local test datasets
├── pyproject.toml       # Python project config
├── AGENTS.md            # AI coding assistant instructions
├── CLAUDE.md            # Claude Code instructions
└── .gitignore
See Structure & Configuration for a detailed breakdown.

​
CLI Context

The CLI scopes platform commands to the workspace repository you are currently inside. It reads Git origin, resolves the GitHub owner/repo, and sends that repository identity to the platform. 
git remote get-url origin
osmosis dataset list
If the CLI cannot resolve the workspace, run: 
osmosis doctor

​
Typical Local Loop

1

Edit or scaffold a rollout

osmosis rollout init <name>
2

Push and sync

git add .
git commit -m "add rollout"
git push
3

Submit an evaluation run

osmosis eval submit configs/eval/<name>.toml
4

Submit training

osmosis train submit configs/training/<name>.toml

​
Next Steps

Workspace Repository

Learn how GitHub origin scopes CLI commands to a platform workspace.

Structure & Configuration

Understand the files in a cloned workspace repository.

Git Sync

Push to GitHub and let the platform sync rollout code automatically.