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

> ## Agent Instructions
> The docs are served at https://docs.devias.io. Every path in these docs is relative to that root: /llms.txt is https://docs.devias.io/llms.txt.
> Devias is an open-source platform that works as an operating system for a business: a core (records, views, workflows, agents, permissions) with installable modules.
> Pages are typed by folder. concepts/ explains what things are, guides/ gives procedures, reference/ is exhaustive (SDK, CLI, HTTP API), operate/ covers hosting. Use /start/glossary for exact terms.
> Every id in a module (module, object, field, view, action, workflow, step, connection, variable, event, policy) is a uuid. Generate them with `devias id <count>`. Never invent dotted or readable ids.
> Run `devias plan` and read its output before `devias apply`. Apply only what the plan says.
> The OpenAPI document, including the routes of the modules in the reference setup, is at /reference/api/openapi.json.
> Devias is young and changes quickly. If a page and the source repository (github.com/devias-io/devias) disagree, the repository is right.

# devias plan

> devias plan lists every change applying a manifest would make, each marked create, update, delete or conflict, without writing anything. Unchanged items are hidden unless --all is passed. Exits with code 2 when the plan has conflicts and 0 otherwise.

`devias plan` shows what applying a manifest would change in a workspace, without changing anything.

```bash theme={"dark"}
devias plan -w <workspaceId> -m ./src/manifest/index.ts
```

The command lists every change, each marked `create`, `update`, `delete` or `conflict`. Unchanged items are hidden unless `--all` is passed.

Nothing is written. The command is always safe to run.

## Exit code

The command exits with `2` when the plan has conflicts and with `0` otherwise. In CI this fails a pull request that would conflict with the workspace.

## Related

* [devias apply](https://docs.devias.io/reference/cli/apply.md): apply the plan.
* [Plan and apply](https://docs.devias.io/guides/modules/plan-and-apply.md): the kinds of change.


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