Bugs and Issues
Issues track bugs, errors, and problems discovered during development.
Reporting Issues
terminal
~/my-project ❯ Houston, register this issue: the login form throws a 500 error when the email field contains a plus sign HOUSTON: Registering issue... ✓ register_issue(title='Login 500 error with plus sign in email', content='The login form returns a 500 when email contains +. Likely a validation or encoding issue.') Issue registered: IS-bug42z Status: open
Working on Issues
terminal
~/my-project ❯ Houston, what issues do we have open? Pick up IS-bug42z and fix it. HOUSTON: Checking issues... ✓ get_issues() Open issues (3): • IS-bug42z - Login 500 error with + in email • IS-glitch7 - Avatar not loading on Safari • IS-err99x - Timeout on large CSV export Taking IS-bug42z... ✓ update_issue_status('IS-bug42z', 'investigating') Investigating the login form validation... The email validation regex doesn't handle the + character. Fixing now...
Converting Issues to Tasks
When an issue requires structured work (multiple steps, agent instructions, tracking), convert it to a task:
terminal
~/my-project ❯ Houston, make a task from issue IS-glitch7 HOUSTON: Reading issue details... ✓ get_issues(issue_id='IS-glitch7') Creating task from issue... ✓ create_task(title='Fix avatar loading on Safari', description='Avatar images fail to load on Safari due to WebP format not being supported on older versions. Ref: IS-glitch7') Task created: TS-fix7sa Linked to issue: IS-glitch7