workspace.yaml reference

`.nepopsx/workspace.yaml` describes the repository, its services, provider targets, installed agents, and team preferences. It is the local source used by scan, install, doctor, and sync.

Create and validate

up creates the workspace from repository detection and guides the full setup. workspace inspect validates its shape and reports actionable health problems before you render.

Terminal

$ nepopsx up

$ nepopsx workspace inspect

Core model

A workspace records identity, services, rendering targets, philosophy, and installed agent configuration.

Organization and workspace identity
Service names, paths, languages, frameworks, and ports
Provider targets such as GitHub Copilot and Claude Code
Philosophy and custom instructions
Installed agents and their enriched configuration

Local and remote state

A normal sync renders from the local workspace. sync --remote first fetches the canonical dashboard model and approved learnings for the selected workspace.

Terminal

$ nepopsx sync

$ nepopsx sync --remote --workspace <slug>