# uip solution init

> Syntax and options for `uip solution init`, which scaffolds an empty UiPath solution directory with a `.uipx` manifest.

`uip solution init` scaffolds an empty UiPath solution on disk. It creates a directory named after the solution, writes a `.uipx` manifest with an empty `Projects` array, and writes `AGENTS.md` and `CLAUDE.md` briefing files that orient AI coding agents to the solution — ready to receive projects via [`uip solution projects add`](./uip-solution-projects.md#add) or [`uip solution projects import`](./uip-solution-projects.md#import).

## Synopsis

```
uip solution init <solutionName>
```

The command honours the [global options](./global-options.md) and returns the [standard exit codes](./exit-codes.md).

## Arguments

- `<solutionName>` *(required)* — Name or path for the new solution. A directory is created at this location; the `.uipx` file inside it takes the same base name.

## Options

None beyond the [global options](./global-options.md).

## Examples

### Minimal

```bash
uip solution init my-solution
```

Creates `./my-solution/my-solution.uipx`, plus `./my-solution/AGENTS.md` and `./my-solution/CLAUDE.md`.

### Scripting — capture the generated path

```bash
uip solution init my-solution --output-filter "Data.Path"
```

Combined with [`--output json`](./global-options.md#--output), emits a single JSON string with the absolute path to the new `.uipx`, suitable for piping into follow-up commands.

## Data shape (--output json)

```json
{
  "Code": "SolutionInit",
  "Data": {
    "Status": "Created successfully",
    "Path": "/workspace/my-solution/my-solution.uipx",
    "NextSteps": "Read /workspace/my-solution/AGENTS.md or /workspace/my-solution/CLAUDE.md to understand the solution lifecycle, project types that can be used inside a solution, and related uip command references."
  }
}
```

`NextSteps` points at whichever briefing file the invoking agent (or a human) should read next — it's the same content in both files, written for different coding-agent conventions.

## Related commands

- [`uip solution projects add`](./uip-solution-projects.md#add) — register an existing project subfolder in the new solution.
- [`uip solution projects import`](./uip-solution-projects.md#import) — copy an external project folder into the new solution.
- [`uip solution pack`](./uip-solution-pack.md) — once projects are added, produce a `.zip` for deployment.

## See also

- [Your first pipeline](./first-pipeline.md) — walks through `init` → `projects add` → `pack` → `publish` → `deploy run`.
- [`uip solution` overview](./uip-solution.md) — verb taxonomy and end-to-end flow.