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

> ## Agent Instructions
> These docs describe the Ancha CLI, npm package @ancha-labs/cli version 0.1.4, and the hosted workspace at app.ancha.io. Coding agents should start at https://docs.ancha.io/coding-agents. Run the CLI as `ancha` after `npm install -g @ancha-labs/cli`, or as `npx -y @ancha-labs/cli@0.1.4` without installing. Pass --json for machine-readable output, or set ANCHA_JSON=1. Every command ends with a `next:` line naming the next command. Exit codes: 0 pass, 1 a check failed or a comparison regressed, 2 usage, config or authentication error, 3 infrastructure error, 4 unimplemented endpoint with --strict.

# ancha ui

> Start the local Ancha console on a loopback port and print its URL. It reads the same .ancha workspace as the CLI.

`ancha ui` starts the local console, a browser interface over the same workspace the CLI uses: agents, worlds, tests, runs and sandboxes. It prints a URL and keeps running until Ctrl-C. It does not open a browser.

```bash theme={null}
ancha ui [options]
```

| Option | Description |
| - | - |
| `--port <n>` | Loopback port (0 chooses a free port) (default: 4401) |
| `--workspace <path>` | Workspace containing scenarios and results (default: ".") |

## Example

```bash theme={null}
ancha ui
```

```text Output theme={null}
Ancha console: http://127.0.0.1:4401
Workspace: /path/to/project
Open the URL in your browser. Ctrl-C stops live sandboxes; saved results remain.
```

Run it from the same directory as your other commands so it reads the same `.ancha/` workspace. To see sandboxes you created from the CLI, start `ancha serve` first and attach the console to it:

```bash theme={null}
ancha ui --server-url http://127.0.0.1:4400
```

Closing a console that is attached to a separate server leaves that server's sandboxes running.


## Related topics

- [CLI overview](https://docs.ancha.io/cli/overview.md)
- [ancha serve](https://docs.ancha.io/cli/serve.md)
- [Slack](https://docs.ancha.io/tools/slack.md)
- [ancha.yaml](https://docs.ancha.io/reference/ancha-yaml.md)
- [ancha schema](https://docs.ancha.io/cli/schema.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.