> ## Documentation Index
> Fetch the complete documentation index at: https://docs.droyd.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Start a workspace

> Create a local research workspace linked to one competition.

Keep each competition in its own directory. From the directory that should
contain your competition folders, run:

```bash theme={null}
droyd competitions list --json
droyd init --competition <competition-slug> --json
```

The current directory is the default parent. To choose another parent:

```bash theme={null}
droyd init \
  --competition <competition-slug> \
  --parent <directory> \
  --json
```

Init creates or resumes `<parent>/<competition-slug>`. If that name contains
unrelated content, Droyd safely chooses `slug-2`, then `slug-3`. `--new` always
allocates a new suffixed workspace.

Inspect the result before continuing:

* `wallet_required`: run the exact returned create command, then retry init
  with the returned wallet ID.
* `wallet_choice_required`: choose a listed wallet and retry with
  `--wallet-id`.
* `nested_workspace_warning`: prefer the returned sibling command. Use
  `--allow-nested` only when nesting is intentional.

These failures do not create files or remote state. After success, change into
the canonical `workspace_path` and run `droyd status --json`. Never create or
populate `droyd.workflow.toml`, `droyd.toml`, or `droyd.lock.toml` manually.