io.github.jobrayan/codmir
NPM · @CODMIR/MCP · SCANNED AUG 3
AI-powered task execution, tickets, sprints, error debugging, and desktop control.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →
Supply Chain Security86
- No malware found by supply-chain analysis.Pass
- Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.Partial
- No install/post-install scripts declared.Pass
- Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency19
- Repository check failed: the declared repository URL returned HTTP 404. See how to fix → View diagnostics → Fail
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (Apache-2.0).Pass
- Actively maintained (last published 64 days ago).Pass
- Security-disclosure policy not yet verified: we couldn't inspect the source repository.Unverified
Schema Quality & AI Usability71
- AI-judged instruction clarity (good).Pass
- Tool/resource definitions use about 2150 tokens (~65/item across 33 items; 33 tools + 0 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Unverified: 1 category
A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
npm · @codmir/mcp
claude mcp add jobrayan-codmir -- npx -y @codmir/mcp
codex mcp add jobrayan-codmir -- npx -y @codmir/mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"jobrayan-codmir": {
"type": "local",
"command": [
"npx",
"-y",
"@codmir/mcp"
],
"enabled": true
}
}
} openclaw mcp add jobrayan-codmir --command npx --arg -y --arg @codmir/mcp
mcp_servers:
jobrayan-codmir:
command: "npx"
args: ["-y", "@codmir/mcp"] {
"mcpServers": {
"jobrayan-codmir": {
"command": "npx",
"args": [
"-y",
"@codmir/mcp"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 2 Aug 26 +38
- Provenance: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. security
- Capabilities: pass → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- Dependency health: unverified → partial ▲ functional
- License: unverified → pass ▲ functional
- Schema quality: unverified → good ▲ functional
- Maintenance: unverified → pass ▲ functional
- First check of Schema quality: unverified functional
- Licence: Apache-2.0 functional
- 1 Aug 26 +5
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- MCP protocol: unverified → pass ▲ functional
- 31 Jul 26 −24
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 27 Jul 26 40
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Analysed npm/@codmir/[email protected]
Provenance none
Ecosystem: npm · Outcome: none
Dependencies 94 packages
94 packages in the resolved dependency tree · 94 deprecated · 29 stale.
The dependency tree was only partially resolved, so these counts may be incomplete.
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
check_task_status ~34
Check the status of a running task execution.
| Name | Type | Req | Description |
|---|---|---|---|
| executionId | string | yes | The execution ID returned when task was started |
No output schema declared.
No examples provided.
codmir_click ~55
Click at screen coordinates (x, y). Use after taking a screenshot to identify the target location.
| Name | Type | Req | Description |
|---|---|---|---|
| x | number | yes | X coordinate (pixels from left) |
| y | number | yes | Y coordinate (pixels from top) |
No output schema declared.
No examples provided.
codmir_connect ~98
Establish a real-time agent session with the Codmir desktop app. This announces the AI provider to the desktop UI, which shows a colored border glow indicating which agent is controlling the screen. Call this at the start of any desktop control session.
| Name | Type | Req | Description |
|---|---|---|---|
| provider | string | yes | AI provider name: claude, gemini, vercel, cursor, windsurf, or custom name |
| session_name | string | — | Optional human-readable session label |
No output schema declared.
No examples provided.
codmir_disconnect ~26
End the agent session with the Codmir desktop app. Removes the border glow indicator.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
codmir_double_click ~38
Double-click at screen coordinates (x, y).
| Name | Type | Req | Description |
|---|---|---|---|
| x | number | yes | X coordinate |
| y | number | yes | Y coordinate |
No output schema declared.
No examples provided.
codmir_fetch_page ~83
Fetch a web page through the desktop agent. Returns HTTP status, headers, page title, all links, and the HTML body (truncated at 50KB). Use this for web app testing, crawling routes, and analyzing page content without needing screenshots.
| Name | Type | Req | Description |
|---|---|---|---|
| url | string | yes | Full URL to fetch (e.g. http://localhost:3000/dashboard) |
No output schema declared.
No examples provided.
codmir_key ~129
Press a keyboard key or key combination. Use macOS key codes. Common: Return=36, Tab=48, Escape=53, Delete=51, Space=49, Up=126, Down=125, Left=123, Right=124. Flags: Shift=0x20000, Control=0x40000, Option=0x80000, Command=0x100000.
| Name | Type | Req | Description |
|---|---|---|---|
| flags | number | — | Modifier flags (e.g. 0x100000 for Command). Default: 0 |
| key_code | number | yes | macOS virtual key code |
No output schema declared.
No examples provided.
codmir_list_directory ~94
List files and directories at a path on the desktop machine. Returns file names, sizes, and types. Useful for understanding project structure, finding config files, or mapping a codebase. Skips node_modules, .git, dist, etc.
| Name | Type | Req | Description |
|---|---|---|---|
| max_depth | number | — | How deep to recurse (default: 1, max recommended: 3) |
| path | string | yes | Absolute directory path to list |
No output schema declared.
No examples provided.
codmir_mouse_move ~43
Move the mouse cursor to screen coordinates (x, y) without clicking.
| Name | Type | Req | Description |
|---|---|---|---|
| x | number | yes | X coordinate |
| y | number | yes | Y coordinate |
No output schema declared.
No examples provided.
codmir_right_click ~43
Right-click at screen coordinates (x, y) to open context menus.
| Name | Type | Req | Description |
|---|---|---|---|
| x | number | yes | X coordinate |
| y | number | yes | Y coordinate |
No output schema declared.
No examples provided.
codmir_scan_routes ~109
Scan multiple routes on a web app and return status codes for each. Useful for finding 404s, broken pages, redirect chains, and 500 errors. Returns a summary (counts of 200/404/3xx/5xx) and per-route results.
| Name | Type | Req | Description |
|---|---|---|---|
| base_url | string | yes | Base URL (e.g. http://localhost:3000) |
| routes | array | yes | Array of route paths to check (e.g. ["/", "/dashboard", "/settings"]) |
No output schema declared.
No examples provided.
codmir_screen_info ~31
Get screen dimensions and the name of the frontmost application. Call this first to understand the display layout.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
codmir_screenshot ~36
Capture a screenshot of the entire screen. Returns a base64-encoded PNG image. Use this to see what is currently displayed.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
codmir_scroll ~73
Scroll at the given screen coordinates. Negative delta scrolls down, positive scrolls up.
| Name | Type | Req | Description |
|---|---|---|---|
| delta | number | — | Scroll amount (negative = down, positive = up). Default: -3 |
| x | number | yes | X coordinate to scroll at |
| y | number | yes | Y coordinate to scroll at |
No output schema declared.
No examples provided.
codmir_shell ~57
Run a shell command on the machine where Codmir desktop is running. Returns stdout, stderr, and exit code.
| Name | Type | Req | Description |
|---|---|---|---|
| command | string | yes | Shell command to execute |
| cwd | string | — | Working directory (default: home directory) |
No output schema declared.
No examples provided.
codmir_status ~31
Check if the Codmir desktop agent is running and connected. Returns status, port, platform, and architecture.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
codmir_type ~40
Type text at the current cursor position. Use codmir_click first to focus the target input field.
| Name | Type | Req | Description |
|---|---|---|---|
| text | string | yes | The text to type |
No output schema declared.
No examples provided.
create_organization ~57
Create a new organization/workspace for the user. Required before creating projects.
| Name | Type | Req | Description |
|---|---|---|---|
| description | string | — | Optional description |
| name | string | yes | Organization name |
| slug | string | — | URL-friendly identifier (auto-generated if omitted) |
No output schema declared.
No examples provided.
create_project ~84
Create a new project within an organization. Required before creating tickets.
| Name | Type | Req | Description |
|---|---|---|---|
| description | string | — | Optional description |
| key | string | — | Short project key for ticket prefixes (auto-generated if omitted) |
| name | string | yes | Project name |
| organizationId | string | — | Organization ID (uses default org if omitted) |
| projectType | string | — | Type of project |
No output schema declared.
No examples provided.
create_ticket ~77
Create a new ticket in Codmir. Use this to capture bugs, features, or tasks from the conversation.
| Name | Type | Req | Description |
|---|---|---|---|
| description | string | — | Detailed description |
| priority | string | — | Ticket priority |
| projectId | string | yes | The project ID |
| title | string | yes | Ticket title |
| type | string | — | Ticket type |
No output schema declared.
No examples provided.
execute_task ~77
Execute an AI-powered code task (bug fix, feature implementation, refactor). The task will be queued and executed by a Codmir agent.
| Name | Type | Req | Description |
|---|---|---|---|
| instructions | string | yes | What the AI agent should do |
| projectId | string | yes | The project ID |
| ticketId | string | — | Optional ticket ID to link this task to |
No output schema declared.
No examples provided.
generate_sdk_code ~69
Generate SDK code for a specific use case. Returns ready-to-use TypeScript code.
| Name | Type | Req | Description |
|---|---|---|---|
| language | string | — | Target language (default: typescript) |
| useCase | string | yes | What the code should do (e.g., "create a ticket for a bug", "list all projects") |
No output schema declared.
No examples provided.
get_error_context ~76
Get enriched error context for AI debugging. Returns the full error report plus suggested files to investigate (extracted from stack frames), a human-readable summary, and similar resolved issues. Ideal for understanding and fixing production errors.
| Name | Type | Req | Description |
|---|---|---|---|
| reference | string | yes | Any error reference — refId, digest, reportId, fingerprint, or issueId |
No output schema declared.
No examples provided.
get_project_context ~34
Get project overview including tech stack, recent activity, and team info.
| Name | Type | Req | Description |
|---|---|---|---|
| projectId | string | yes | The project ID |
No output schema declared.
No examples provided.
get_sdk_reference ~56
Get Codmir SDK API reference for a specific topic. Use this to learn how to use the SDK for tickets, projects, organizations, chat, or agent tasks.
| Name | Type | Req | Description |
|---|---|---|---|
| topic | string | yes | Which SDK topic to get reference for |
No output schema declared.
No examples provided.
get_sprint_tasks ~58
Get tasks for the current or specified sprint. Returns all tasks with their status, assignee, and ticket details.
| Name | Type | Req | Description |
|---|---|---|---|
| projectId | string | yes | The project ID |
| status | string | — | Filter by status (default: all) |
No output schema declared.
No examples provided.
get_workspace_status ~27
Check if user has organization and projects set up. Call this first if other tools fail.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list_project_tasks ~45
List all tasks for a project.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | number | — | Max number of tasks to return (default: 20) |
| projectId | string | yes | The project ID |
No output schema declared.
No examples provided.
list_recent_errors ~86
List recent production errors from the Overseer error store. Returns the most recent errors with their refId, message, severity, route, and timestamp. Useful for getting an overview of current production issues.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | number | — | Max number of errors to return (default: 20, max: 50) |
| severity | string | — | Filter by severity (default: all) |
No output schema declared.
No examples provided.
list_todo ~125
Get the to-do list for a project — tickets filtered as actionable items (open/in_progress), sorted by priority. Excludes tickets with auto-execution workflow enabled. Use this for an overview of what needs to be done.
| Name | Type | Req | Description |
|---|---|---|---|
| assigneeId | string | — | Filter by assignee user ID |
| limit | number | — | Max items to return (default: 50) |
| priority | string | — | Filter by priority (default: all) |
| projectId | string | yes | The project ID |
| status | string | — | Filter by status (default: all actionable) |
No output schema declared.
No examples provided.
lookup_error ~95
Look up a production error report by any reference: refId (err_xxx), Next.js digest (3681244270), reportId (rpt_xxx), fingerprint (fp_xxx), or issueId (ISS-xxx). Returns the full stored error report with stack trace, breadcrumbs, and metadata.
| Name | Type | Req | Description |
|---|---|---|---|
| reference | string | yes | Any error reference — refId, digest, reportId, fingerprint, or issueId |
No output schema declared.
No examples provided.
store_conversation ~96
Save this conversation as project documentation. Use to preserve important context, solutions, or decisions.
| Name | Type | Req | Description |
|---|---|---|---|
| content | string | — | Full content to save |
| projectId | string | yes | The project ID |
| summary | string | yes | Summary of the conversation |
| tags | array | — | Tags for categorization |
| ticketId | string | — | Optional ticket to link to |
| title | string | yes | Title for the saved context |
No output schema declared.
No examples provided.
update_todo_status ~68
Update the status of a to-do item (ticket). Use to mark items as done, in progress, or reopen them.
| Name | Type | Req | Description |
|---|---|---|---|
| projectId | string | yes | The project ID |
| status | string | yes | New status |
| ticketId | string | yes | The ticket ID to update |
No output schema declared.
No examples provided.