Tools

Kompass uses structured tools to keep workflows grounded in repository and GitHub state instead of inferred context.

Current built-in tools:

• changes_load
• command_expansion
• pr_load
• pr_sync
• ticket_load
• ticket_sync

Built-in tools

changes_load

Loads either uncommitted worktree changes or a base/head git comparison, returning structured file diffs and optional commit metadata.

command_expansion

Resolves an explicit command plus body into a rendered prompt so a navigator can delegate it immediately through task.

pr_load

Loads normalized PR metadata, review history, issue comments, review threads, repo identity, and viewer identity from GitHub.

pr_sync

Creates PRs, updates PR metadata, posts comments and replies, and submits formal reviews against an existing PR.

ticket_load

Loads a ticket from GitHub issue references, local files, or raw text, with optional GitHub comments.

ticket_sync

Creates or updates GitHub issues, renders checklist sections, and can append issue comments.