cleankoda logo

Issue Tracking System (ITS)

cleankoda integrates directly with your existing project management and ticketing systems (e.g., Trello, Jira, or GitHub Issues). The coding agent can load requirements, acceptance criteria, and contextual information directly from your tickets to seamlessly align the implementation process with them.

Configuration (config.json)

The issue tracker is currently configured via the central configuration file (interactive setup directly within the TUI using slash commands is in development):

~/.config/cleankoda/config.json

Enter the connection parameters and the status mapping for your system there. Here is an example:

{
  "its_type": "Trello",
  "its_base_url": "https://api.trello.com/1",
  "its_container_id": "1234567890",
  "its_parent_id": "",
  "its_state_backlog": "Backlog",
  "its_state_todo": "Sprint Backlog",
  "its_state_in_progress": "In Progress",
  "its_state_in_review": "In Review",
  "its_state_done": "Done"
}

Parameter Overview:

  • its_type: The system being used (e.g., Trello, Jira, GitHub).

  • its_base_url: The provider’s API endpoint.

  • its_container_id: The ID of the board, project, or repository containing your tickets.

  • its_parent_id: Optional parent ID (e.g., for epics or sub-tasks).

  • its_state_*: The mapping between cleankoda’s internal workflow states and the actual column or status labels in your ticket system:

  • its_state_backlog → Status for BACKLOG

  • its_state_todo → Status for TODO

  • its_state_in_progress → Status for IN_PROGRESS

  • its_state_in_review → Status for IN_REVIEW

  • its_state_done → Status for DONE

Ticket Management in the Terminal (/issue)

Once issue tracking is configured, you can conveniently manage tickets using the /issue commands in the TUI:

Select Issue and Load Context

Link a specific ticket to your current work session:

  • By ID or URL:
/issue <id_oder_url>
/issue

(Opens a dialog to select from the available tickets on the configured board).

Note: Upon loading, cleankoda automatically transfers the ticket description (e.g., user story, problem description, acceptance criteria) into the agent’s work context.

Additional issue commands

  • Show content:
/issue show

Displays the details and content of the ticket currently active in the context in a clear format.

  • Update ticket:
/issue sync

Fetches the latest ticket changes from the server (e.g., if criteria were added or comments were posted on the board) and updates the agent’s context.

  • Clear issue:
/issue clear

Removes the currently linked ticket from the agent’s work context.