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, question or type:<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 runs gh issue edit to remove the old state:<id> label and add the new one (the label is created in purple if it does not exist), then runs the new state’s on_enter_script (bash, with ISSUE_NUM, ISSUE_TITLE, ORG, REPO, STATE_ID and STATE_LABEL set) and on_enter_prompt (sent to gh copilot with 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 clone into ~/source/<org>/<repo> if needed, fetches, and checks out the branch issue-<number>. A task server can supply its own workspace_setup_script instead, which runs with ISSUE_NUM, ORG, REPO and REPO_DIR set. Open in VS Code runs code on 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.