sophia/CLAUDE.md

Sophia

Dev helper (bin/dev)

bin/dev wraps common project tasks. Run bin/dev bash-completions to list commands.

Creating issues

Use bin/dev issue to create Gitea issues instead of calling the API or tea directly:

bin/dev issue "<title>" [-b "<body>"] [-l <label>]... [-a <user>]... [--open]

• Labels are repo label names (bug, enhancement, question, ...).
• The Gitea API cannot add an issue to a project. After creating an issue, tell the user its URL so they can add it to the "sophia" project (issue sidebar > Projects), or pass --open.
• Only create issues when the user asks; issues are visible on the remote.