devto-mcp 0.1.9 → 0.2.1

package/README.md

@@ -10,6 +10,8 @@ npm install -g devto-mcp
 
 Requires Node.js >= 18 and [Claude Code](https://claude.ai/claude-code).
 
+This is a one-time global install. Each project is linked individually via `devto init` — uninstalling from one project does not affect others.
+
 ## Setup
 
 1. Create an account and get an API key at [devto.ai](https://devto.ai)
@@ -21,12 +23,38 @@ devto login
 devto config set anthropic-key sk-ant-xxxx
 ```
 
-3. Connect to Claude Code:
+3. In your project directory, link to DevTo:
 
 ```bash
+cd your-project
 devto init
 ```
 
+This creates:
+- `.devto.json` — project config (workspace URL, project key, provider)
+- `.devto/config.json` — credentials (API key, scoped to this project)
+- `.mcp.json` — Claude Code MCP server config
+
+Both `.devto.json` and `.devto/` are added to `.gitignore` automatically.
+
+4. Restart Claude Code to pick up the MCP config.
+
+## Per-project configuration
+
+Each project gets its own `.devto.json` in the project root:
+
+```json
+{
+  "workspaceUrl": "https://yourcompany.atlassian.net",
+  "projectKey": "ENG",
+  "provider": "jira"
+}
+```
+
+When the MCP server starts, it walks up the directory tree from the current working directory looking for `.devto.json`. If found, that workspace and project are used for all API calls. If not found, it falls back to the tenant's default workspace.
+
+**Add `.devto.json` to your `.gitignore`.** It may contain a workspace ID. `devto init` does this automatically.
+
 ## Usage
 
 In Claude Code:
@@ -41,17 +69,29 @@ DevTo generates a structured plan. Run `confirm_plan` to push it to your project
 
 | Command | Description |
 |---|---|
-| `devto login` | Authenticate with your API key |
-| `devto status` | Show connection and usage info |
-| `devto init` | Auto-configure MCP in Claude Code |
+| `devto login` | Authenticate with your API key (global) |
+| `devto init` | Link this project to DevTo |
+| `devto unlink` | Unlink this project (removes .devto.json, .devto/, registry entry) |
+| `devto status` | Show connection and active project config |
 | `devto doctor` | Run diagnostics |
 | `devto sync` | Re-sync workspace config |
 | `devto config set anthropic-key` | Store your Anthropic key locally |
 
+### Unlinking a project
+
+```bash
+devto unlink
+```
+
+This removes `.devto.json`, `.devto/`, the devto entry from `.mcp.json`, and the project from `~/.devto/projects.json`. It does **not** uninstall the global package.
+
+To fully remove DevTo: `npm uninstall -g devto-mcp`.
+
 ## MCP tools
 
 | Tool | Description |
 |---|---|
+| `get_project_summary` | Lightweight snapshot of active work |
 | `create_plan` | Generate a plan from a feature description |
 | `confirm_plan` | Execute a plan and create all work items |
 | `create_epic` | Create an epic |
@@ -61,6 +101,10 @@ DevTo generates a structured plan. Run `confirm_plan` to push it to your project
 | `update_task` | Update a task's status |
 | `get_status` | Get project summary |
 
+## Project registry
+
+DevTo keeps a registry of linked projects at `~/.devto/projects.json`. This is used internally to track which directories are linked. You don't need to edit it manually.
+
 ## Dashboard
 
 Manage your workspace, API keys, and billing at [devto.ai/dashboard](https://devto.ai/dashboard).

package/dist/cli.d.ts

@@ -6,13 +6,12 @@
  *   devto login                          Authenticate with your DevTo API key
  *   devto logout                         Clear global credentials
  *   devto status                         Show current connection status
- *   devto init                           Auto-configure Claude Code MCP config
+ *   devto init                           Link this project to DevTo
+ *   devto unlink                         Unlink this project from DevTo
  *   devto doctor                         Test full connection chain
  *   devto sync                           Re-sync workspace configuration
  *   devto verbose                        Toggle verbose mode
  *   devto config set anthropic-key <key> Store Anthropic API key
- *   devto uninstall                      Remove DevTo from this project
- *   devto uninstall --purge              Remove DevTo from this project + global config
  */
 export {};
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;GAcG"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;GAaG"}