---
summary: "CLI reference for `SKYKOI setup` (initialize config + workspace)"
read_when:
  - You’re doing first-run setup without the full onboarding wizard
  - You want to set the default workspace path
title: "setup"
---

# `SKYKOI setup`

Initialize `~/.SKYKOI/SKYKOI.json` and the koi workspace.

Related:

- Getting started: [Getting started](/start/getting-started)
- Wizard: [Onboarding](/start/onboarding)

## Examples

```bash
SKYKOI setup
SKYKOI setup --workspace ~/.SKYKOI/workspace
```

To run the wizard via setup:

```bash
SKYKOI setup --wizard
```