{"_id":"@agentira/mcp","_rev":"6-42fbb569a59a89c312effb07e670c0b2","name":"@agentira/mcp","dist-tags":{"latest":"0.0.4"},"versions":{"0.0.2":{"name":"@agentira/mcp","version":"0.0.2","keywords":["mcp","project-management","features","bugs","agentic","ai"],"author":"","license":"MIT","_id":"@agentira/mcp@0.0.2","maintainers":[{"name":"thealienbit","email":"thealienbit@outlook.com"}],"bin":{"agentira":"bin/agentira.cjs"},"dist":{"shasum":"733b23490339b1aa1a3ffe84d9d3b5c5617c16e9","tarball":"https://registry.npmjs.org/@agentira/mcp/-/mcp-0.0.2.tgz","fileCount":32,"integrity":"sha512-h5apaY9+mieUFPSWRXXC7RV3TzucGOWddg6FuaTEn+4UeJA36jTWTHwppUPrRfcwiEe6be51NowYCxTO3RMLwg==","signatures":[{"sig":"MEUCIQCtBmATWvmxmzV+oFNijY48GDAQ9Aq5/8so1R0QrPSboQIgA6jdRZ5Qe085olJcdLmCLdQpZHp/sGobqtmlZK7ygOE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2086576},"main":"app/server/mcp.js","type":"module","gitHead":"54fb5fc7c4740655538e3b86f5ffcf5fadd708c2","scripts":{"dev":"concurrently \"npm run server\" \"npm run client\"","build":"cd app/client && npm run build","client":"cd app/client && npm run dev","server":"node app/server/index.js","install:all":"npm install && cd app/client && npm install && cd ../server && npm install","postinstall":"npm install --ignore-scripts"},"_npmUser":{"name":"thealienbit","email":"thealienbit@outlook.com"},"_npmVersion":"11.11.0","description":"MCP server for managing Features and Bugs as markdown files - built for agentic coders","directories":{},"_nodeVersion":"25.8.1","dependencies":{"cors":"^2.8.6","express":"^5.2.1","fs-extra":"^11.3.4","gray-matter":"^4.0.3","@modelcontextprotocol/sdk":"^1.28.0"},"_hasShrinkwrap":false,"devDependencies":{"concurrently":"^8.2.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.0.2_1774728949798_0.5614004448359811","host":"s3://npm-registry-packages-npm-production"}},"0.0.3":{"name":"@agentira/mcp","version":"0.0.3","keywords":["mcp","project-management","features","bugs","agentic","ai"],"author":"","license":"MIT","_id":"@agentira/mcp@0.0.3","maintainers":[{"name":"thealienbit","email":"thealienbit@outlook.com"}],"bin":{"agentira":"bin/agentira.cjs"},"dist":{"shasum":"2978c1cf758b4eb91e0b64714e87f01b79ddb121","tarball":"https://registry.npmjs.org/@agentira/mcp/-/mcp-0.0.3.tgz","fileCount":32,"integrity":"sha512-XQyEmfw7WlmSTn/IncgycwAOr1oHxeBxAhlf4rmVAuvkQdbktE3vbyFkRT6M4Ug+vP+11axOYQv+8j4ArnhiCg==","signatures":[{"sig":"MEUCIQCc2wMdGW3dpEFmRcI6nRx5Xs4PNIOQhrLUWjX5sRHTCAIgXHvzjosK++nUJDQWNvUYzm1VrBg3GUxQqMW3DVNOdxg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2086525},"main":"app/server/mcp.js","type":"module","gitHead":"54fb5fc7c4740655538e3b86f5ffcf5fadd708c2","scripts":{"dev":"concurrently \"npm run server\" \"npm run client\"","build":"cd app/client && npm run build","client":"cd app/client && npm run dev","server":"node app/server/index.js","install:all":"npm install && cd app/client && npm install && cd ../server && npm install"},"_npmUser":{"name":"thealienbit","email":"thealienbit@outlook.com"},"_npmVersion":"11.11.0","description":"MCP server for managing Features and Bugs as markdown files - built for agentic coders","directories":{},"_nodeVersion":"25.8.1","dependencies":{"cors":"^2.8.6","express":"^5.2.1","fs-extra":"^11.3.4","gray-matter":"^4.0.3","@modelcontextprotocol/sdk":"^1.28.0"},"_hasShrinkwrap":false,"devDependencies":{"concurrently":"^8.2.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.0.3_1774729349132_0.8106664385154736","host":"s3://npm-registry-packages-npm-production"}},"0.0.4":{"name":"@agentira/mcp","version":"0.0.4","description":"MCP server for managing Features and Bugs as markdown files - built for agentic coders","type":"module","main":"app/server/mcp.js","bin":{"agentira":"bin/agentira.cjs"},"scripts":{"build":"cd app/client && npm run build","dev":"concurrently \"npm run server\" \"npm run client\"","server":"node app/server/index.js","client":"cd app/client && npm run dev","install:all":"npm install && cd app/client && npm install && cd ../server && npm install"},"keywords":["mcp","project-management","features","bugs","agentic","ai"],"author":"","license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.28.0","cors":"^2.8.6","express":"^5.2.1","fs-extra":"^11.3.4","gray-matter":"^4.0.3"},"devDependencies":{"concurrently":"^8.2.2"},"gitHead":"cb93152dbfc4209812d164f74b04a29ba38f2bcc","_id":"@agentira/mcp@0.0.4","_nodeVersion":"25.8.1","_npmVersion":"11.11.0","dist":{"integrity":"sha512-2f2gzXgeFCyQBlT3iALU7FwLykjZWCwsuZ4SI+o4zgWLXl/RRKDsapoQZZa9kWkbKDeHzCOS035gUNAoMyN+yA==","shasum":"9aaa982f2eb2a55461a7c469697bc5b73a38d175","tarball":"https://registry.npmjs.org/@agentira/mcp/-/mcp-0.0.4.tgz","fileCount":32,"unpackedSize":2086659,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCNEdjUjk/VothqFqXcFuLNak7vqAqRLE2VZvOWzP9feAIgGBGjiS2pQOZmt12Sx7/C8SYOywuImhE00E4I9C/WPiI="}]},"_npmUser":{"name":"thealienbit","email":"thealienbit@outlook.com"},"directories":{},"maintainers":[{"name":"thealienbit","email":"thealienbit@outlook.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.0.4_1774730095486_0.058617502777351005"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-28T20:15:49.555Z","modified":"2026-03-28T20:34:56.080Z","0.0.1":"2026-03-28T20:00:05.494Z","0.0.2":"2026-03-28T20:15:50.047Z","0.0.3":"2026-03-28T20:22:29.339Z","0.0.4":"2026-03-28T20:34:55.679Z"},"license":"MIT","keywords":["mcp","project-management","features","bugs","agentic","ai"],"description":"MCP server for managing Features and Bugs as markdown files - built for agentic coders","maintainers":[{"name":"thealienbit","email":"thealienbit@outlook.com"}],"readme":"# TheManager\n\nA minimalist project management tool built for **agentic coders** — developers who leverage AI coding assistants (Claude, Cursor, Windsurf, etc.) to build software.\n\n## What is this?\n\nTheManager is a local-first project management app that manages **Features** and **Bugs** as markdown files in your project's `feats/` and `bugs/` directories.\n\n**Key Philosophy:** Your project, your data, your machine. No cloud, no account, no sync friction.\n\n## For Agentic Coders\n\nWhen AI agents work on features or fix bugs, they need context about:\n- What features are being built and why?\n- What bugs exist and their impact?\n- What's the current status of work?\n\nTheManager provides:\n- **Structured Markdown Files** — Each feat/bug has sections for What & Why, Impact, Developer Notes, and Testing Notes\n- **Status Tracking** — Move items through `new` → `inprogress` → `finished` states\n- **Agentic Access via MCP** — AI coding assistants can read and write to your project management via the MCP protocol\n\n```\nAgent: \"Create a new feat for user authentication\"\nTheManager: Creates feats/new/user-auth.md with structured template\n\nAgent: \"What features are in progress?\"\nTheManager: Lists all items with status=inprogress\n```\n\n## Project Structure\n\n```\nyour-project/\n├── feats/\n│   ├── new/              # Newly proposed features\n│   ├── inprogress/       # Features being worked on\n│   └── finished/         # Completed features\n├── bugs/\n│   ├── new/              # Reported bugs\n│   ├── inprogress/       # Bugs being fixed\n│   └── finished/         # Resolved bugs\n└── ...your code...\n```\n\n## Getting Started\n\n### Prerequisites\n- Node.js 18+\n- npm 9+\n\n### Option 1: Install via npm (Recommended)\n\n```bash\n# Install globally\nnpm install -g @agentira/mcp\n\n# Verify installation\nagentira --help\n```\n\n### Option 2: Clone from GitHub\n\n```bash\n# Clone the repository\ngit clone https://github.com/yourusername/themanager.git\ncd themanager\n\n# Install dependencies\nnpm install -g\n\n# Link for development\nnpm link\n```\n\n### Development\n\n```bash\n# Start the app (frontend + backend)\nnpm run dev\n```\n\nThe app will open at `http://localhost:5173`\n\n### Production Build\n\n```bash\nnpm run build\n```\n\n## Usage\n\n### 1. Select Your Project\nWhen you first open the app, enter the path to your project directory:\n```\n/Users/you/Dev/your-project\n```\n\nTheManager will create the `feats/` and `bugs/` directories with the proper structure.\n\n### 2. Create Features & Bugs\n- Click \"+ New Feature\" or \"+ New Bug\" from the dashboard\n- Fill in the markdown content with structured sections\n- Items start in `new/` status\n\n### 3. Track Progress\nMove items between statuses:\n- **new** — Just created, not started\n- **inprogress** — Being worked on\n- **finished** — Completed\n\n### 4. Agentic Access via MCP\nConfigure your AI coding assistant to access TheManager via MCP. When the MCP server starts, it also serves the web UI at **http://localhost:3001** for convenient access.\n\n**Note:** When the MCP server is running via an AI assistant, you can access the web UI at the same time.\n\n#### OpenCode\nAdd to your `opencode.jsonc`:\n```jsonc\n{\n  \"$schema\": \"https://opencode.ai/config.json\",\n  \"mcp\": {\n    \"agentira\": {\n      \"type\": \"local\",\n      \"command\": [\"agentira\", \"/path/to/your/project\"],\n      \"enabled\": true\n    }\n  }\n}\n```\n\nOr add directly via CLI:\n```bash\nopencode mcp add agentira -- agentira /path/to/your/project\n```\n\n**Note:** Add the mcp configuration at project level for better user experience. Add feats/ and bugs/ directories into .gitignore.\n\n#### Claude Desktop\nAdd to `~/.claude_desktop_config.json`:\n```json\n{\n  \"mcpServers\": {\n    \"agentira\": {\n      \"command\": \"agentira\",\n      \"args\": [\"/path/to/your/project\"]\n    }\n  }\n}\n```\n\n#### Cursor\nAdd to Cursor settings (`settings.json`):\n```json\n{\n  \"mcpServers\": {\n    \"agentira\": {\n      \"command\": \"agentira\",\n      \"args\": [\"/path/to/your/project\"]\n    }\n  }\n}\n```\n\n#### Available MCP Tools\n| Tool | Description |\n|------|-------------|\n| `list_items` | List all feats or bugs, optionally filtered by status |\n| `get_item` | Get a single item with full content |\n| `create_item` | Create a new feat or bug |\n| `update_item` | Update title or body content |\n| `move_item` | Move item to new status (new/inprogress/finished) |\n| `delete_item` | Delete an item |\n| `search_items` | Search by title or content |\n\n#### Example Agent Conversations\n```\nAgent: \"What features are in progress?\"\nTool: list_items({ type: \"feats\", status: \"inprogress\" })\n\nAgent: \"File a bug for the login timeout\"\nTool: create_item({ type: \"bugs\", title: \"Login timeout after 5 minutes\" })\n\nAgent: \"Mark auth feature as finished\"\nTool: move_item({ type: \"feats\", id: \"feat-abc123\", status: \"finished\" })\n```\n\n## Feature File Structure\n\nEach markdown file uses YAML frontmatter + structured body:\n\n```markdown\n---\nid: feat-m1abc123\ntitle: User authentication\nstatus: new\ncreated: 2026-03-26\nupdated: 2026-03-26\n---\n\n## What & Why\nDescribe what we're trying to do and why this matters.\n\n## Impact\nWhat happens if we do this? What changes?\n\n## Developer Notes\nTechnical details, architecture decisions, gotchas.\n\n## Testing Notes\nHow should this be tested? Edge cases to consider.\n```\n\n## Tech Stack\n\n- **Frontend:** React 18 + Vite + TailwindCSS\n- **Backend:** Node.js + Express\n- **Storage:** Local filesystem (markdown files)\n- **MCP:** Model Context Protocol for agentic access\n\n## License\n\nMIT\n","readmeFilename":"README.md"}