@aaronshaf/plane 0.1.2

package/src/commands/issue.ts

@@ -0,0 +1,409 @@
+import { Command, Options, Args } from "@effect/cli"
+import { Console, Effect } from "effect"
+import { api, decodeOrFail } from "../api.js"
+import {
+  IssueSchema,
+  ActivitiesResponseSchema,
+  IssueLinksResponseSchema,
+  IssueLinkSchema,
+  CommentsResponseSchema,
+  WorklogsResponseSchema,
+  WorklogSchema,
+} from "../config.js"
+import { parseIssueRef, findIssueBySeq, getStateId, resolveProject } from "../resolve.js"
+
+const refArg = Args.text({ name: "ref" }).pipe(
+  Args.withDescription("Issue reference, e.g. PROJ-29"),
+)
+
+// --- issue get ---
+
+export const issueGet = Command.make("get", { ref: refArg }, ({ ref }) =>
+  Effect.gen(function* () {
+    const { projectId, seq } = yield* parseIssueRef(ref)
+    const issue = yield* findIssueBySeq(projectId, seq)
+    yield* Console.log(JSON.stringify(issue, null, 2))
+  }),
+).pipe(
+  Command.withDescription(
+    "Print full JSON for an issue. Useful for inspecting all fields (state, priority, assignees, labels, etc.).",
+  ),
+)
+
+// --- issue update ---
+
+const stateOption = Options.optional(Options.text("state")).pipe(
+  Options.withDescription("State group or name (e.g. backlog, completed)"),
+)
+
+const priorityOption = Options.optional(
+  Options.choice("priority", ["urgent", "high", "medium", "low", "none"]),
+).pipe(Options.withDescription("Issue priority"))
+
+export const issueUpdate = Command.make(
+  "update",
+  { state: stateOption, priority: priorityOption, ref: refArg },
+  ({ ref, state, priority }) =>
+    Effect.gen(function* () {
+      const { projectId, seq } = yield* parseIssueRef(ref)
+      const issue = yield* findIssueBySeq(projectId, seq)
+
+      const body: Record<string, unknown> = {}
+
+      if (state._tag === "Some") {
+        body["state"] = yield* getStateId(projectId, state.value)
+      }
+      if (priority._tag === "Some") {
+        body["priority"] = priority.value
+      }
+
+      if (Object.keys(body).length === 0) {
+        yield* Effect.fail(new Error("Nothing to update. Specify --state or --priority"))
+      }
+
+      const raw = yield* api.patch(`projects/${projectId}/issues/${issue.id}/`, body)
+      const updated = yield* decodeOrFail(IssueSchema, raw)
+      yield* Console.log(
+        `Updated ${ref}: state=${String(updated.state)} priority=${updated.priority}`,
+      )
+    }),
+).pipe(
+  Command.withDescription(
+    "Update an issue's state or priority. Options must come before the REF argument.\n\nExamples:\n  plane issue update --state completed PROJ-29\n  plane issue update --priority high WEB-5\n  plane issue update --state started --priority medium OPS-3",
+  ),
+)
+
+// --- issue comment ---
+
+const textArg = Args.text({ name: "text" }).pipe(
+  Args.withDescription("Comment text to add"),
+)
+
+export const issueComment = Command.make(
+  "comment",
+  { ref: refArg, text: textArg },
+  ({ ref, text }) =>
+    Effect.gen(function* () {
+      const { projectId, seq } = yield* parseIssueRef(ref)
+      const issue = yield* findIssueBySeq(projectId, seq)
+      const escaped = text.replace(/</g, "&lt;").replace(/>/g, "&gt;")
+      yield* api.post(`projects/${projectId}/issues/${issue.id}/comments/`, {
+        comment_html: `<p>${escaped}</p>`,
+      })
+      yield* Console.log(`Comment added to ${ref}`)
+    }),
+).pipe(
+  Command.withDescription(
+    "Add a comment to an issue. The text is wrapped in <p> tags and HTML-escaped.\n\nExample:\n  plane issue comment PROJ-29 \"Fixed in latest build\"",
+  ),
+)
+
+// --- issue create ---
+
+const titleArg = Args.text({ name: "title" }).pipe(
+  Args.withDescription("Issue title"),
+)
+const projectRefArg = Args.text({ name: "project" }).pipe(
+  Args.withDescription("Project identifier (e.g. PROJ)"),
+)
+
+const createPriorityOption = Options.optional(
+  Options.choice("priority", ["urgent", "high", "medium", "low", "none"]),
+).pipe(Options.withDescription("Issue priority"))
+
+const createStateOption = Options.optional(Options.text("state")).pipe(
+  Options.withDescription("Initial state group or name"),
+)
+
+export const issueCreate = Command.make(
+  "create",
+  { priority: createPriorityOption, state: createStateOption, project: projectRefArg, title: titleArg },
+  ({ project, title, priority, state }) =>
+    Effect.gen(function* () {
+      const { key, id: projectId } = yield* resolveProject(project)
+      const body: Record<string, unknown> = { name: title }
+      if (priority._tag === "Some") body["priority"] = priority.value
+      if (state._tag === "Some") body["state"] = yield* getStateId(projectId, state.value)
+      const raw = yield* api.post(`projects/${projectId}/issues/`, body)
+      const created = yield* decodeOrFail(IssueSchema, raw)
+      yield* Console.log(`Created ${key}-${created.sequence_id}: ${created.name}`)
+    }),
+).pipe(
+  Command.withDescription(
+    "Create a new issue in a project.\n\nExamples:\n  plane issue create PROJ \"Migrate Button component\"\n  plane issue create --priority high --state started PROJ \"Fix lint pipeline\"",
+  ),
+)
+
+// --- issue activity ---
+
+export const issueActivity = Command.make("activity", { ref: refArg }, ({ ref }) =>
+  Effect.gen(function* () {
+    const { projectId, seq } = yield* parseIssueRef(ref)
+    const issue = yield* findIssueBySeq(projectId, seq)
+    const raw = yield* api.get(`projects/${projectId}/issues/${issue.id}/activities/`)
+    const { results } = yield* decodeOrFail(ActivitiesResponseSchema, raw)
+    if (results.length === 0) {
+      yield* Console.log("No activity found")
+      return
+    }
+    const lines = results.map((a) => {
+      const who = a.actor_detail?.display_name ?? "?"
+      const when = a.created_at.slice(0, 16).replace("T", " ")
+      if (a.field) {
+        const from = a.old_value ?? "—"
+        const to = a.new_value ?? "—"
+        return `${when}  ${who}  ${a.field}: ${from} → ${to}`
+      }
+      return `${when}  ${who}  ${a.verb ?? "updated"}`
+    })
+    yield* Console.log(lines.join("\n"))
+  }),
+).pipe(
+  Command.withDescription(
+    "Show audit trail for an issue — who changed what and when.\n\nExample:\n  plane issue activity PROJ-29",
+  ),
+)
+
+// --- issue link list ---
+
+export const issueLinkList = Command.make("list", { ref: refArg }, ({ ref }) =>
+  Effect.gen(function* () {
+    const { projectId, seq } = yield* parseIssueRef(ref)
+    const issue = yield* findIssueBySeq(projectId, seq)
+    const raw = yield* api.get(`projects/${projectId}/issues/${issue.id}/issue-links/`)
+    const { results } = yield* decodeOrFail(IssueLinksResponseSchema, raw)
+    if (results.length === 0) {
+      yield* Console.log("No links")
+      return
+    }
+    const lines = results.map((l) => `${l.id}  ${l.title ?? "(no title)"}  ${l.url}`)
+    yield* Console.log(lines.join("\n"))
+  }),
+).pipe(Command.withDescription("List URL links attached to an issue."))
+
+// --- issue link add ---
+
+const urlArg = Args.text({ name: "url" }).pipe(Args.withDescription("URL to link"))
+const linkTitleOption = Options.optional(Options.text("title")).pipe(
+  Options.withDescription("Human-readable title for the link"),
+)
+
+export const issueLinkAdd = Command.make(
+  "add",
+  { title: linkTitleOption, ref: refArg, url: urlArg },
+  ({ ref, url, title }) =>
+    Effect.gen(function* () {
+      const { projectId, seq } = yield* parseIssueRef(ref)
+      const issue = yield* findIssueBySeq(projectId, seq)
+      const body: Record<string, string> = { url }
+      if (title._tag === "Some") body["title"] = title.value
+      const raw = yield* api.post(
+        `projects/${projectId}/issues/${issue.id}/issue-links/`,
+        body,
+      )
+      const link = yield* decodeOrFail(IssueLinkSchema, raw)
+      yield* Console.log(`Link added: ${link.id}  ${link.url}`)
+    }),
+).pipe(
+  Command.withDescription(
+    "Attach a URL link to an issue.\n\nExamples:\n  plane issue link add PROJ-29 https://github.com/org/repo/pull/42\n  plane issue link add --title \"Design doc\" PROJ-29 https://docs.example.com",
+  ),
+)
+
+// --- issue link remove ---
+
+const linkIdArg = Args.text({ name: "link-id" }).pipe(
+  Args.withDescription("Link ID (from 'plane issue link list')"),
+)
+
+export const issueLinkRemove = Command.make(
+  "remove",
+  { ref: refArg, linkId: linkIdArg },
+  ({ ref, linkId }) =>
+    Effect.gen(function* () {
+      const { projectId, seq } = yield* parseIssueRef(ref)
+      const issue = yield* findIssueBySeq(projectId, seq)
+      yield* api.delete(`projects/${projectId}/issues/${issue.id}/issue-links/${linkId}/`)
+      yield* Console.log(`Link ${linkId} removed from ${ref}`)
+    }),
+).pipe(Command.withDescription("Remove a URL link from an issue by link ID."))
+
+// --- issue link (parent) ---
+
+export const issueLink = Command.make("link").pipe(
+  Command.withDescription(
+    "Manage URL links on an issue. Subcommands: list, add, remove",
+  ),
+  Command.withSubcommands([issueLinkList, issueLinkAdd, issueLinkRemove]),
+)
+
+// --- issue comments list ---
+
+export const issueCommentsList = Command.make("list", { ref: refArg }, ({ ref }) =>
+  Effect.gen(function* () {
+    const { projectId, seq } = yield* parseIssueRef(ref)
+    const issue = yield* findIssueBySeq(projectId, seq)
+    const raw = yield* api.get(`projects/${projectId}/issues/${issue.id}/comments/`)
+    const { results } = yield* decodeOrFail(CommentsResponseSchema, raw)
+    if (results.length === 0) {
+      yield* Console.log("No comments")
+      return
+    }
+    const lines = results.map((c) => {
+      const who = c.actor_detail?.display_name ?? "?"
+      const when = c.created_at.slice(0, 16).replace("T", " ")
+      const text = (c.comment_html ?? "").replace(/<[^>]+>/g, "").trim()
+      return `${c.id}  ${when}  ${who}: ${text}`
+    })
+    yield* Console.log(lines.join("\n"))
+  }),
+).pipe(
+  Command.withDescription(
+    "List comments on an issue. Shows comment ID, timestamp, author, and plain text.\n\nExample:\n  plane issue comments list PROJ-29",
+  ),
+)
+
+// --- issue comment update ---
+
+const commentIdArg = Args.text({ name: "comment-id" }).pipe(
+  Args.withDescription("Comment ID (from 'plane issue comments list')"),
+)
+
+export const issueCommentUpdate = Command.make(
+  "update",
+  { ref: refArg, commentId: commentIdArg, text: textArg },
+  ({ ref, commentId, text }) =>
+    Effect.gen(function* () {
+      const { projectId, seq } = yield* parseIssueRef(ref)
+      const issue = yield* findIssueBySeq(projectId, seq)
+      const escaped = text.replace(/</g, "&lt;").replace(/>/g, "&gt;")
+      yield* api.patch(
+        `projects/${projectId}/issues/${issue.id}/comments/${commentId}/`,
+        { comment_html: `<p>${escaped}</p>` },
+      )
+      yield* Console.log(`Comment ${commentId} updated`)
+    }),
+).pipe(
+  Command.withDescription(
+    "Edit an existing comment.\n\nExample:\n  plane issue comments update PROJ-29 <comment-id> \"Updated text\"",
+  ),
+)
+
+// --- issue comment delete ---
+
+export const issueCommentDelete = Command.make(
+  "delete",
+  { ref: refArg, commentId: commentIdArg },
+  ({ ref, commentId }) =>
+    Effect.gen(function* () {
+      const { projectId, seq } = yield* parseIssueRef(ref)
+      const issue = yield* findIssueBySeq(projectId, seq)
+      yield* api.delete(
+        `projects/${projectId}/issues/${issue.id}/comments/${commentId}/`,
+      )
+      yield* Console.log(`Comment ${commentId} deleted`)
+    }),
+).pipe(Command.withDescription("Delete a comment from an issue."))
+
+// --- issue comments (parent) ---
+
+export const issueComments = Command.make("comments").pipe(
+  Command.withDescription("Manage comments on an issue. Subcommands: list, update, delete\n\nNote: use 'plane issue comment REF TEXT' to add a new comment."),
+  Command.withSubcommands([issueCommentsList, issueCommentUpdate, issueCommentDelete]),
+)
+
+// --- issue worklogs list ---
+
+export const issueWorklogsList = Command.make("list", { ref: refArg }, ({ ref }) =>
+  Effect.gen(function* () {
+    const { projectId, seq } = yield* parseIssueRef(ref)
+    const issue = yield* findIssueBySeq(projectId, seq)
+    const raw = yield* api.get(`projects/${projectId}/issues/${issue.id}/worklogs/`)
+    const { results } = yield* decodeOrFail(WorklogsResponseSchema, raw)
+    if (results.length === 0) {
+      yield* Console.log("No worklogs")
+      return
+    }
+    const lines = results.map((w) => {
+      const who = w.logged_by_detail?.display_name ?? "?"
+      const when = w.created_at.slice(0, 10)
+      const hrs = (w.duration / 60).toFixed(1)
+      const desc = w.description ?? ""
+      return `${w.id}  ${when}  ${who}  ${hrs}h  ${desc}`
+    })
+    yield* Console.log(lines.join("\n"))
+  }),
+).pipe(
+  Command.withDescription(
+    "List time log entries for an issue. Duration shown in hours.\n\nExample:\n  plane issue worklogs list PROJ-29",
+  ),
+)
+
+// --- issue worklogs add ---
+
+const durationArg = Args.integer({ name: "minutes" }).pipe(
+  Args.withDescription("Time spent in minutes"),
+)
+const worklogDescOption = Options.optional(Options.text("description")).pipe(
+  Options.withDescription("Optional description of work done"),
+)
+
+export const issueWorklogsAdd = Command.make(
+  "add",
+  { description: worklogDescOption, ref: refArg, duration: durationArg },
+  ({ ref, duration, description }) =>
+    Effect.gen(function* () {
+      const { projectId, seq } = yield* parseIssueRef(ref)
+      const issue = yield* findIssueBySeq(projectId, seq)
+      const body: Record<string, unknown> = { duration }
+      if (description._tag === "Some") body["description"] = description.value
+      const raw = yield* api.post(
+        `projects/${projectId}/issues/${issue.id}/worklogs/`,
+        body,
+      )
+      const log = yield* decodeOrFail(WorklogSchema, raw)
+      const hrs = (log.duration / 60).toFixed(1)
+      yield* Console.log(`Logged ${hrs}h on ${ref} (${log.id})`)
+    }),
+).pipe(
+  Command.withDescription(
+    "Log time spent on an issue (duration in minutes).\n\nExamples:\n  plane issue worklogs add PROJ-29 90\n  plane issue worklogs add --description \"code review\" PROJ-29 30",
+  ),
+)
+
+// --- issue worklogs (parent) ---
+
+export const issueWorklogs = Command.make("worklogs").pipe(
+  Command.withDescription("Manage time logs for an issue. Subcommands: list, add"),
+  Command.withSubcommands([issueWorklogsList, issueWorklogsAdd]),
+)
+
+// --- issue delete ---
+
+export const issueDelete = Command.make("delete", { ref: refArg }, ({ ref }) =>
+  Effect.gen(function* () {
+    const { projectId, seq } = yield* parseIssueRef(ref)
+    const issue = yield* findIssueBySeq(projectId, seq)
+    yield* api.delete(`projects/${projectId}/issues/${issue.id}/`)
+    yield* Console.log(`Deleted ${ref}`)
+  }),
+).pipe(Command.withDescription("Permanently delete an issue. This cannot be undone."))
+
+// --- issue (parent) ---
+
+export const issue = Command.make("issue").pipe(
+  Command.withDescription(
+    "Manage individual issues. Use 'plane issue <subcommand> --help' for details.\n\nSubcommands: get, create, update, delete, comment, activity, link, comments, worklogs",
+  ),
+  Command.withSubcommands([
+    issueGet,
+    issueCreate,
+    issueUpdate,
+    issueDelete,
+    issueComment,
+    issueActivity,
+    issueLink,
+    issueComments,
+    issueWorklogs,
+  ]),
+)

package/src/commands/issues.ts

@@ -0,0 +1,51 @@
+import { Command, Options, Args } from "@effect/cli"
+import { Console, Effect } from "effect"
+import { api, decodeOrFail } from "../api.js"
+import { IssuesResponseSchema } from "../config.js"
+import { formatIssue } from "../format.js"
+import { resolveProject } from "../resolve.js"
+import type { State } from "../config.js"
+
+const projectArg = Args.text({ name: "project" }).pipe(
+  Args.withDescription("Project identifier — see 'plane projects list' for available identifiers"),
+)
+
+const stateOption = Options.optional(Options.text("state")).pipe(
+  Options.withDescription(
+    "Filter by state group (backlog | unstarted | started | completed | cancelled) or exact state name",
+  ),
+)
+
+export const issuesList = Command.make(
+  "list",
+  { state: stateOption, project: projectArg },
+  ({ project, state }) =>
+    Effect.gen(function* () {
+      const { key, id } = yield* resolveProject(project)
+      const raw = yield* api.get(`projects/${id}/issues/?order_by=sequence_id`)
+      const { results } = yield* decodeOrFail(IssuesResponseSchema, raw)
+
+      const filtered =
+        state._tag === "Some"
+          ? results.filter((i) => {
+              const s = i.state as State | string
+              if (typeof s !== "object") return false
+              const val = state.value.toLowerCase()
+              return s.group === val || s.name.toLowerCase() === val
+            })
+          : results
+
+      yield* Console.log(filtered.map((i) => formatIssue(i, key)).join("\n"))
+    }),
+).pipe(
+  Command.withDescription(
+    "List issues for a project ordered by sequence ID. Each line shows: REF  [state-group]  state-name  title",
+  ),
+)
+
+export const issues = Command.make("issues").pipe(
+  Command.withDescription(
+    "List and filter issues. Use 'plane issues list --help' for filtering options.",
+  ),
+  Command.withSubcommands([issuesList]),
+)

package/src/commands/labels.ts

@@ -0,0 +1,54 @@
+import { Command, Options, Args } from "@effect/cli"
+import { Console, Effect } from "effect"
+import { api, decodeOrFail } from "../api.js"
+import { LabelsResponseSchema, LabelSchema } from "../config.js"
+import { resolveProject } from "../resolve.js"
+
+const projectArg = Args.text({ name: "project" }).pipe(
+  Args.withDescription("Project identifier (e.g. PROJ, WEB, OPS)"),
+)
+
+// --- labels list ---
+
+export const labelsList = Command.make("list", { project: projectArg }, ({ project }) =>
+  Effect.gen(function* () {
+    const { id } = yield* resolveProject(project)
+    const raw = yield* api.get(`projects/${id}/labels/`)
+    const { results } = yield* decodeOrFail(LabelsResponseSchema, raw)
+    if (results.length === 0) {
+      yield* Console.log("No labels found")
+      return
+    }
+    const lines = results.map(
+      (l) => `${l.id}  ${(l.color ?? "").padEnd(8)}  ${l.name}`,
+    )
+    yield* Console.log(lines.join("\n"))
+  }),
+)
+
+// --- labels create ---
+
+const nameArg = Args.text({ name: "name" }).pipe(
+  Args.withDescription("Label name"),
+)
+const colorOption = Options.optional(Options.text("color")).pipe(
+  Options.withDescription("Hex color e.g. #ff0000"),
+)
+
+export const labelsCreate = Command.make(
+  "create",
+  { color: colorOption, project: projectArg, name: nameArg },
+  ({ project, name, color }) =>
+    Effect.gen(function* () {
+      const { id } = yield* resolveProject(project)
+      const body: Record<string, unknown> = { name }
+      if (color._tag === "Some") body["color"] = color.value
+      const raw = yield* api.post(`projects/${id}/labels/`, body)
+      const label = yield* decodeOrFail(LabelSchema, raw)
+      yield* Console.log(`Created label: ${label.name} (${label.id})`)
+    }),
+)
+
+export const labels = Command.make("labels").pipe(
+  Command.withSubcommands([labelsList, labelsCreate]),
+)

package/src/commands/members.ts

@@ -0,0 +1,20 @@
+import { Command } from "@effect/cli"
+import { Console, Effect } from "effect"
+import { api, decodeOrFail } from "../api.js"
+import { MembersResponseSchema } from "../config.js"
+
+export const membersList = Command.make("list", {}, () =>
+  Effect.gen(function* () {
+    const raw = yield* api.get("members/")
+    const results = yield* decodeOrFail(MembersResponseSchema, raw)
+    const lines = results.map((m) => {
+      const email = m.email ? `  <${m.email}>` : ""
+      return `${m.display_name.padEnd(24)}${email}`
+    })
+    yield* Console.log(lines.join("\n"))
+  }),
+)
+
+export const members = Command.make("members").pipe(
+  Command.withSubcommands([membersList]),
+)

package/src/commands/modules.ts

@@ -0,0 +1,129 @@
+import { Command, Args } from "@effect/cli"
+import { Console, Effect } from "effect"
+import { api, decodeOrFail } from "../api.js"
+import { ModulesResponseSchema, ModuleIssuesResponseSchema } from "../config.js"
+import { resolveProject, parseIssueRef, findIssueBySeq } from "../resolve.js"
+
+const projectArg = Args.text({ name: "project" }).pipe(
+  Args.withDescription("Project identifier (e.g. PROJ, WEB, OPS)"),
+)
+
+const moduleIdArg = Args.text({ name: "module-id" }).pipe(
+  Args.withDescription("Module UUID (from 'plane modules list PROJECT')"),
+)
+
+// --- modules list ---
+
+export const modulesList = Command.make("list", { project: projectArg }, ({ project }) =>
+  Effect.gen(function* () {
+    const { id } = yield* resolveProject(project)
+    const raw = yield* api.get(`projects/${id}/modules/`)
+    const { results } = yield* decodeOrFail(ModulesResponseSchema, raw)
+    if (results.length === 0) {
+      yield* Console.log("No modules found")
+      return
+    }
+    const lines = results.map((m) => {
+      const status = (m.status ?? "?").padEnd(12)
+      return `${m.id}  ${status}  ${m.name}`
+    })
+    yield* Console.log(lines.join("\n"))
+  }),
+).pipe(
+  Command.withDescription(
+    "List modules for a project. Shows module UUID, status, and name.\n\nExample:\n  plane modules list PROJ",
+  ),
+)
+
+// --- modules issues list ---
+
+export const moduleIssuesList = Command.make(
+  "list",
+  { project: projectArg, moduleId: moduleIdArg },
+  ({ project, moduleId }) =>
+    Effect.gen(function* () {
+      const { key, id } = yield* resolveProject(project)
+      const raw = yield* api.get(`projects/${id}/modules/${moduleId}/module-issues/`)
+      const { results } = yield* decodeOrFail(ModuleIssuesResponseSchema, raw)
+      if (results.length === 0) {
+        yield* Console.log("No issues in module")
+        return
+      }
+      const lines = results.map((mi) => {
+        if (mi.issue_detail) {
+          const seq = String(mi.issue_detail.sequence_id).padStart(3, " ")
+          return `${key}-${seq}  ${mi.issue_detail.name}  (${mi.id})`
+        }
+        return `${mi.issue}  (module-issue: ${mi.id})`
+      })
+      yield* Console.log(lines.join("\n"))
+    }),
+).pipe(
+  Command.withDescription(
+    "List issues in a module.\n\nExample:\n  plane modules issues list PROJ <module-id>",
+  ),
+)
+
+// --- modules issues add ---
+
+const issueRefArg = Args.text({ name: "ref" }).pipe(
+  Args.withDescription("Issue reference to add (e.g. PROJ-29)"),
+)
+
+export const moduleIssuesAdd = Command.make(
+  "add",
+  { project: projectArg, moduleId: moduleIdArg, ref: issueRefArg },
+  ({ project, moduleId, ref }) =>
+    Effect.gen(function* () {
+      const { id: projectId } = yield* resolveProject(project)
+      const { seq } = yield* parseIssueRef(ref)
+      const issue = yield* findIssueBySeq(projectId, seq)
+      yield* api.post(`projects/${projectId}/modules/${moduleId}/module-issues/`, {
+        issues: [issue.id],
+      })
+      yield* Console.log(`Added ${ref} to module ${moduleId}`)
+    }),
+).pipe(
+  Command.withDescription(
+    "Add an issue to a module.\n\nExample:\n  plane modules issues add PROJ <module-id> PROJ-29",
+  ),
+)
+
+// --- modules issues remove ---
+
+const moduleIssueIdArg = Args.text({ name: "module-issue-id" }).pipe(
+  Args.withDescription("Module-issue join ID (from 'plane modules issues list')"),
+)
+
+export const moduleIssuesRemove = Command.make(
+  "remove",
+  { project: projectArg, moduleId: moduleIdArg, moduleIssueId: moduleIssueIdArg },
+  ({ project, moduleId, moduleIssueId }) =>
+    Effect.gen(function* () {
+      const { id } = yield* resolveProject(project)
+      yield* api.delete(
+        `projects/${id}/modules/${moduleId}/module-issues/${moduleIssueId}/`,
+      )
+      yield* Console.log(`Removed module-issue ${moduleIssueId} from module ${moduleId}`)
+    }),
+).pipe(
+  Command.withDescription(
+    "Remove an issue from a module using the module-issue join ID.\n\nExample:\n  plane modules issues remove PROJ <module-id> <module-issue-id>",
+  ),
+)
+
+// --- modules issues (parent) ---
+
+export const moduleIssues = Command.make("issues").pipe(
+  Command.withDescription("Manage issues within a module. Subcommands: list, add, remove"),
+  Command.withSubcommands([moduleIssuesList, moduleIssuesAdd, moduleIssuesRemove]),
+)
+
+// --- modules (parent) ---
+
+export const modules = Command.make("modules").pipe(
+  Command.withDescription(
+    "Manage modules (groups of related issues). Subcommands: list, issues\n\nExamples:\n  plane modules list PROJ\n  plane modules issues list PROJ <module-id>\n  plane modules issues add PROJ <module-id> PROJ-29",
+  ),
+  Command.withSubcommands([modulesList, moduleIssues]),
+)