create_issue
Creates an issue and a matching branch. Infers labels, a board priority/effort, and a native Issue Type from the task (toggle with OKFFSINFERPRIORITY/OKFFSINFEREFFORT/OKFFSINFERTYPE). Optional assignees, labels, milestone, priority, effort, type. Opens a draft PR immediately when OKFFSAUTOPR=true.
How to use it
Project documentation lists create_issue for the Okffs MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), then check which tools your installed version makes available. Tool availability can depend on configuration and credentials. A server handshake does not verify this tool’s behavior. See the full listing for setup details.
Install Okffs
npx @neturely/okffs@latestOther tools in Okffs (20)
Closes an issue and tips you to /clear before the next one.
Posts a comment — handy for logging what a branch did.
Stages, commits (message from your hint or the diff), pushes, and posts a progress comment to the issue.
Writes okffs config to .env — the backend for the /okffs:setup prompt. Reuses the okffs setup wizard's manifest/serializer: updates only okffs's marked block, preserving your own variables and comments. Usually driven by /okffs:setup, not called directly.
Creates many issues + branches from a task list in one shot. Confirms first. Per-task labels, assignees, milestone, priority, effort, type.
Opens a PR for an issue branch — generates the title/body, pushes the branch, always includes Closes #N, and comments back. Can write changelog fragments when OKFFSUPDATEDOCS=true. Pass allowempty: true to backfill a draft tracking PR on a branch with no commits (pushes an empty init commit to diver
Deletes a branch and closes its issue. Destructive — needs confirmed: true.
Closes an issue and deletes its branch. Destructive — needs confirmed: true.
Full details for one issue: title, body, labels, assignees, branch, status.
Links two issues (blockedby, blocking, parent), stored under a ## Relationships section.
Lists open issues with branch, linked PR, board column, priority:/effort:, native type:, and relationships as a tree — ordered by priority so the most important work is on top.
Fetches a PR's inline review threads and summaries.
The one okffs tool that merges: autonomously merges a green, review-resolved issue PR into the base branch (e.g. develop) using OKFFSBASEMERGEMETHOD, then closes the issue. Opt-in (OKFFSAUTOMERGEBASE=true) and heavily gated — never touches OKFFSPROTECTEDBRANCH, independently verifies checks/mergeabi
Give it a free-text description plus the breakdown Claude generates (titles, descriptions, labels, priority/effort/type, relationships); it creates every issue + branch, wires up relationships, and opens draft PRs when OKFFSAUTOPR=true. Confirms first.
Bumps the version, rolls the CHANGELOG, commits on a release branch, and opens a PR. Confirms first; does not tag or publish.
Replies to an inline review thread by id.
Resolves a review thread — only when OKFFSRESOLVETHREADS=true.
Sets board Priority/Effort and/or the native Issue Type on an existing issue. Priority/Effort handle project-native and org-level Issue Fields (needs OKFFSPROJECTENABLED); type is org-native and works independently. createissue only sets these at creation; use this afterwards. Status stays with upda
Edits an existing issue's core fields — title, assignees, labels, milestone, body — via one PATCH with the configured token. labels/assignees replace the whole set ([] clears). For Priority/Effort/Type use setissuefields; for Status use updateprojectstatus.
Moves an issue between board columns (Backlog, Ready, In Progress, Review). Needs OKFFSPROJECTENABLED.