Non-Closing Connection Proxy #

DatabaseConnection.getConnection() returns a proxy that ignores close(). You can safely use try-with-resources — it won’t actually close the underlying connection. This is intentional; the connection is shared across all repositories.

SQLite WAL Mode Side Files #

WAL mode creates -shm and -wal files alongside dmsi.db. Do not delete these while the application is running. They are automatically cleaned up on shutdown.

Single Instance Lock #

If the application crashes, the lock file at %APPDATA%\Claudius Corp\.claudius.lock may be stale. Delete it manually before restarting.

MCP Port File #

If the MCP port file is deleted while an agent is running, the agent cannot reconnect to the bridge. The port file is written at startup. Do not delete it manually while agents are active.

Workflow Design — Avoid Cycles #

When designing custom workflows, ensure the phase graph is a DAG (directed acyclic graph). Circular connections between phases will cause execution issues. Always validate your workflow design before saving.

For the full MCP tool reference, see the API Documentation.

For deployment instructions, see the Deployment Guide.