Skip to Content

Connect CNB to Your AI Agent

Find repositories, work on issues, manage pull requests, and inspect builds.

14 toolsAPI key

20,000 free app calls every month(paid services billed separately)

Try a CNB Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo SkillCNB

Triage an issue queue

Filter open issues, inspect descriptions, and record follow-up comments.

/oo CNB: List open issues in my selected repository, inspect the issue I choose, and add my follow-up comment.

Start Working with CNB

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect CNB

    Create a CNB personal access token with access to the target repositories and operations.

    Connect CNB→
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →
  • Create an access token at https://cnb.cool/profile/token.
  • Private repositories require explicit access; listing repositories requires account-engage:r.
  • Connecting checks only that the token is nonempty. CNB validates it and its permissions on execution.

CNB Tools

Use a personal access token to query repositories, create and update issues and pull requests, exchange issue comments, and read build history and status.

Find repositories

Browse accessible repositories and inspect repository details.

Track issues

Create and update issues, filter work queues, and exchange comments.

Manage pull requests

Create cross-branch pull requests, inspect details, and update descriptions or workflow states.

Inspect builds

Query build history and inspect an existing build without starting new work.

14 tools

List Repositories

List repositories accessible to the current user. Requires account-engage:r. The default minimum role is Guest; increase page until an empty page is returned.

cnb.list_repositories

Get Repository

Get repository information. Requires repo-basic-info:r.

cnb.get_repository

List Issues

List and filter repository issues. Requires repo-issue:r. Increase page until an empty page is returned.

cnb.list_issues

Get Issue

Get an issue with its full description and metadata. Requires repo-issue:r.

cnb.get_issue

Create Issue

Create a repository issue with optional labels, assignees, dates and priority. Requires repo-issue:rw.

cnb.create_issue

Update Issue

Update issue content, dates, visibility, priority or workflow state. Supply state and state_reason together. Requires repo-issue:rw.

cnb.update_issue

List Issue Comments

List issue comments. Requires repo-notes:r. Increase page until an empty page is returned.

cnb.list_issue_comments

Create Issue Comment

Add a comment to an issue. Requires repo-notes:rw.

cnb.create_issue_comment

List Pull Requests

List repository pull requests with filters. Requires repo-pr:r. Increase page until an empty page is returned.

cnb.list_pull_requests

Get Pull Request

Get pull request details and mergeability information. Requires repo-pr:r.

cnb.get_pull_request

Create Pull Request

Create a pull request from a source branch into a target branch. Requires repo-pr:rw.

cnb.create_pull_request

Update Pull Request

Update a pull request title, description or open/closed workflow state. Requires repo-pr:rw.

cnb.update_pull_request

List Builds

List pipeline build history, filtered by branch, event, commit or status. Requires repo-cnb-history:r.

cnb.list_builds

Get Build Status

Get the current state and pipeline progress of an existing build. Requires repo-cnb-trigger:r.

cnb.get_build_status

Frequently Asked Questions

Which token permissions do I need?

Each action describes its required permission. Issues use repo-issue, comments use repo-notes, and pull requests use repo-pr; grant read or write access for the operations you use.

How do I retrieve more records?

Lists use page and page_size. Repositories, issues, comments and pull requests return items; increase page until an empty page is returned. Build history preserves data, total and timestamp.

Do these actions upload attachments or start builds?

The initial action set excludes attachment transfer, build submission, PR merging and repository administration. Generic proxy can access other CNB APIs allowed by your token.