AI tools that understand Orca
AI tools connected to Orca now get a map of how it works (stacks, orca.yaml, workspaces, the gateway, databases, worktrees), and can read Orca's whole documentation through a new orca_docs tool. The docs are built into Orca, so they always match the version you run, and need no web access. Before an AI tool writes orca.yaml or orca-workspace.yaml, it's told to read the relevant page instead of guessing keys.
Move projects onto shared databases
The Databases page now lists every project's own database container. Once a project requires its database on a shared server, its row offers Import into …, which copies the data over:
- Orca takes a snapshot of the new database first, so you can go back.
- A stopped container is started for the copy and stopped again.
- The copy streams from one container straight into the other.
- Between MariaDB and MySQL, the dump is translated on the way: collations, and the first line of MariaDB's dumps that MySQL rejects.
- Containers with a random admin password are read with the app's own user.
AI tools get the same with find_database_services and database_import. So you can now ask:
Consolidate our apps' databases into shared databases defined in the workspace, and move their data over.
In our test, Claude:
- read the docs;
- took stock of every app's database;
- noticed a WordPress site ran MariaDB while the team wanted MySQL, and asked;
- added the shared servers to the workspace;
- wrote
requires:for each app; - copied the data over;
- compared rows on both sides, and checked that the apps still worked.
Also
- Update on the Workspace page no longer fails when the workspace's repo can't be pulled (your own commits, or offline). It says so and applies the workspace as it is in its folder, including your local edits.