Settings
App-wide status, browser checks, forge credentials, new project, and clone onboard. Per-project name/git live on Project.
App status
Your password
Changing the password signs out your other sessions. Scripts keep using Authorization: Bearer.
People
Named accounts share every project. Admins can add or remove people. Per-project permissions are not implemented yet. Scripts still use the instance Bearer token.
Only admins can add or remove accounts.
Rebuild images
API and PWA are compiled images (the frontend has no source mount). Neither api nor grok gets docker.sock. Rebuild is
this page or develescent-query.sh rebuild — the API writes a
root-owned 0600 rebuild.request. The sidecar pins compose and watch-rebuild.sh at start and ignores Grok-uid files. Bind
addresses come from compose.env, not the sidecar environment.
Do not put tokens in the repo tree. Host grok image: docker compose up -d --build grok.
Grok bridge is not connected. From deploy/: docker compose up -d grok, then docker compose run --rm -it grok auth if needed.
Browser checks
Build asks for a UI check through develescent-query.sh preview-run. Passwords stay
in the API secrets box. This page cannot start the browser container.
Preview status is unavailable. Rebuild the API image if this checkout is newer than the running API.
Only admins can store site logins and allow Build to run a check.
Forge credentials
Shared across all projects for private clone, push, and publish. Secrets encrypted at rest;
only label/provider shown after save. The API and Grok containers do not mount host SSH keys —
HTTPS remotes plus a stored PAT are required. After one credential is saved, Grok can request develescent-query.sh git-push (token never leaves the API). To copy tokens
that already live on the host (git credential helper / gh / env), run ./scripts/import-host-git-credentials.sh on the host — not inside compose Grok.
SSH keys are not imported.
Add credential
App passwords are deprecated. Create an Atlassian API token with Bitbucket scopes (Account → Security → API tokens). Store your Atlassian email as username (REST
APIs). Git push automatically uses x-bitbucket-api-token-auth — email as the git
username is rejected by Bitbucket. Required scopes include read:repository:bitbucket and write:repository:bitbucket.
New project
Create an empty directory under REPOS_DIR and register it. Does not publish. Does
not start Grok unless Start Intent workshop is checked. Next: Intent on Memory / Grok, then first commit, then Publish on Project.
Clone onboard
Clone an HTTPS repository under REPOS_DIR and register a new project. The API
chowns the tree to the host user (HOST_UID) so Grok Build can edit on the host.
Starting from scratch? Use New project instead of cloning.
Edit the display name afterward on Project.