Skip to content

Initialize a workspace

Terminal window
lasso init <path> \
--name <name> \
--runtime=codex[,claude][,grok] \
--module=<id> --module=<id>
FlagDefaultMeaning
pathrequiredNew or empty directory
--namedirectory basenameWorkspace display name
--runtimecodexAgent runtimes to adapt for
--modulecatalog default = trueExtra modules to install

Guided path: invoke the lasso-init skill.

lasso.toml name + runtimes
lasso.lock.toml pinned modules
project-defs/registry.toml
projects/
work-items/active/
plugins/lasso-core/
.lasso/modules/ installed module payloads
AGENTS.md
CLAUDE.md → @AGENTS.md
.codex/agents/ reviewer adapters
.claude/agents/
.agents/plugins/marketplace.json
.claude-plugin/marketplace.json
docs/INDEX.md
  1. cd into the workspace
  2. Install lasso-core into your agent runtime
  3. Register projects with lasso project add
  4. Run lasso-doctor if discovery fails