Skip to content

assist db

Getting started sets up the database and applies its migrations with assist db migrate.

  • assist db status prints whether the database matches this version of assist, is behind it and needs assist db migrate, or is ahead of it and assist needs updating.
  • assist db drop-retired drops the tables of features assist no longer has, asking about each one first.

These apply when working on assist itself, where an agent can’t change the database schema without your approval.

  • assist schema unlock internal sends a pin to your desktop notifications, authorising schema changes for the session’s backlog item phase, or for the Claude session when there is no item. Called by agents whose schema change was blocked.
  • assist schema confirm <pin> internal approves those schema changes. Called by agents whose schema change was blocked, with the pin you give them.
  • assist schema lock revokes that approval, for the session’s backlog item phase, or the Claude session when there is no item.