reset-webui-password

Reset the Catalyst Code web UI password by deleting local account files and restarting the hub.

10|1|Updated Jul 7, 2026
One-click install
npx skills add https://github.com/catalystctl/catcode --skill reset-webui-password-catalystctl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reset-webui-password
Source: https://github.com/catalystctl/catcode/tree/main/.catalyst-code/skills/reset-webui-password
Command: npx skills add https://github.com/catalystctl/catcode --skill reset-webui-password-catalystctl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? The Catalyst Code web UI has no forgot-password flow, so a lost login password locks you out of the browser interface entirely. This Skill walks through the supported recovery path: deleting the local account files and restarting the hub so first-run setup can be completed again. ## Core Features & Use Cases - Account file removal: Deletes only account.json (argon2 hash) and devices.json from ~/.config/catalyst-code/, leaving projects, layout, and session history intact. - Hub restart guidance: Covers stopping and starting the hub via systemctl --user, system-level systemd units, killing the catcode-web process, or running ./scripts/run-web.sh. - Use Case: You forgot your CatCode web UI password on a self-hosted install. Run this Skill to wipe the local account, restart the hub, and complete first-run setup at http://127.0.0.1:49283 with a new display name and password. ## Quick Start Reset my Catalyst Code web UI password by deleting the local account files and restarting the hub so I can set a new password.

Frequently Asked Questions about reset-webui-password

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I reset my Catalyst Code web UI password?

Stop the hub, delete `account.json` and `devices.json` from `~/.config/catalyst-code/`, then restart the hub. Open the web UI and complete first-run setup with a new display name and password of at least 8 characters.

Is there a forgot-password flow in the CatCode web UI?

No, the app has no forgot-password flow. The hub stores a single local account as an argon2 hash in `account.json`, so the only recovery method is deleting the account files and restarting the hub.

Will resetting the web UI password delete my chat history?

No, as long as you only delete `account.json` and `devices.json`. Leave `hub-layout.json`, `projects.json`, and the `sessions/` directory in place so open projects and session JSONL history survive the reset.

Does resetting the password sign out other devices?

Yes, deleting `devices.json` signs out every device that had a cookie for the hub. Live cores die with the hub process, but session data on disk still resumes after restart.

How do I restart the catalyst-code-web service after deleting account files?

Run `systemctl --user start catalyst-code-web.service`, or fall back to `sudo systemctl start catalyst-code-web.service` for a system unit. Alternatively, start the hub directly with `./scripts/run-web.sh`.