Issue Manager
Opens one GitHub issue, shows it with its workflow state, moves it between states by changing labels, and sets up a branch workspace for it.
packages/issue-manager
Issue Manager is launched for one issue at a time, usually from another RobOS app. It has no Kanban board and no issue list.
Start it
electron packages/issue-manager 123
electron packages/issue-manager config
The first form opens issue #123 (a leading # is accepted). The second opens the workflow configuration. Without an argument the issue view reports that no repository or issue is selected.
Requirements
The gh CLI, signed in, and a task server in ~/.config/robos/settings.json (task_servers, with active_task_server) that lists the repository. Issues are fetched with gh issue view.
The issue view
- The header shows the number, title, assignees and a type badge. The type is inferred from a label such as
bug,feature,task,chore,security,performance,questionortype:<name>. - Description renders the issue body as Markdown, and Steps to Reproduce appears when the body has a heading such as
## Steps to reproduce. - Workflow State shows the issue’s states as a pipeline. The current state is the issue label
state:<id>(or the bare<id>), and the workflow’s initial state when there is none. Transitions lists the moves the workflow allows. A transition runsgh issue editto remove the oldstate:<id>label and add the new one (the label is created in purple if it does not exist), then runs the new state’son_enter_script(bash, withISSUE_NUM,ISSUE_TITLE,ORG,REPO,STATE_IDandSTATE_LABELset) andon_enter_prompt(sent togh copilotwith all tools allowed) if the workflow defines them. It also writes the issue number to~/.config/robos/active-issue, which Desktop Widgets shows as the active task. - Set Up Workspace clones the repository with
gh repo cloneinto~/source/<org>/<repo>if needed, fetches, and checks out the branchissue-<number>. A task server can supply its ownworkspace_setup_scriptinstead, which runs withISSUE_NUM,ORG,REPOandREPO_DIRset. Open in VS Code runscodeon that folder. - AI Agent has an Ask box. Your question is sent with the issue title and the first 800 characters of its body to
gh copilot -p ... --allow-all-tools, and the output streams into the panel. This needs the GitHub Copilot CLI extension and runs with all tools allowed. - The GitHub button opens the issue in a browser.
The configuration view
The Workflow Studio screen edits the issue types and workflows of the active task server and saves them back to settings.json (Save, Clear All, + Add Issue Type). AI Generate asks gh copilot for a JSON list of issue types and fills the form from it. Saving also appends a note to the daily file in the journal repository when journal_repo is set in the settings, committing and pushing it.
Source: packages/issue-manager.
More in Architecture & Planning
Automation Studio
Editor for event rules and cron-style scheduled jobs, plus a viewer for the daily event log.
Knowledge Graph Explorer
Browse, search, edit and validate the knowledge graph of your software, compare main with a branch, and import or refine graph data from source repositories.
People Directory
Searchable list of people with contact and org fields, stored as JSON files on your machine.
People Manager
Prototype roster screen for teams of people and AI agents, grouped by Team Topologies type. It shows built-in sample data.
RobOS Create Project & App Wizard
Scaffold a new project from an archetype, or import an existing folder, and register it in the RobOS project files.
RobOS Documentation
Lists the components in the knowledge graph, shows which have a documentation page, and lets you generate, edit and export those pages.
RobOS Group Manager
Create and edit developer groups (members, repositories, software, onboarding steps, secrets, CI) and set up a sample company identity.
Schema Studio & Registry
Browse the bundled Schema.org vocabulary, generate JSON-LD, TypeSpec, SHACL and code stubs for a new entity, and validate JSON-LD against RobOS shapes.
System Topology Studio
Prototype C4-style canvas that shows a built-in sample system (Acme Petshop). Backstage import and C4 export return canned results.
Task Board
Read-only board and list view of the issues in the active GitHub task server, grouped by status.
Task Servers
Settings screen where you add Jira and GitHub issue trackers, store a pass path for the token, and test the connection.
Workflow Studio
Define issue types, states and transitions for a GitHub task server, move an issue between states, and run a script or AI prompt when it enters a state.