figmanage 0.2.0 → 0.3.0

package/README.md

@@ -2,7 +2,7 @@
 
 MCP server for managing your Figma workspace.
 
-Manages Figma workspaces through AI assistants. 79 tools covering files, projects, teams, permissions, comments, versions, components, webhooks, org admin, and more. Works with Claude Code, Claude Desktop, ChatGPT, and any MCP-compatible client.
+Manages Figma workspaces through AI assistants. 85 tools covering files, projects, teams, permissions, comments, versions, components, webhooks, org admin, and more. Works with Claude Code, Claude Desktop, ChatGPT, and any MCP-compatible client.
 
 ## quick start
 
@@ -16,19 +16,25 @@ claude mcp add figmanage -s user -e FIGMA_PAT=figd_xxx -- npx -y figmanage
 
 Restart Claude Code. Gives you 30+ tools (comments, reading, export, components, versions, webhooks).
 
-### full setup (2 minutes, all 79 tools)
+### full setup (2 minutes, all 85 tools)
 
 ```bash
 npx -y figmanage --setup
 ```
 
-Extracts your Chrome cookie, prompts for a PAT, registers with Claude Code automatically. Unlocks all 79 tools including workspace management, permissions, and org admin. Restart Claude Code.
+Extracts your Chrome cookie, prompts for a PAT, registers with Claude Code automatically. Unlocks all 85 tools including workspace management, permissions, and org admin. Restart Claude Code.
 
 Use `--no-prompt --pat figd_xxx` for non-interactive setup.
 
-### Claude Desktop
+### Claude Desktop / Cowork
 
-Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+Full setup with cookie extraction:
+
+```bash
+npx -y figmanage --setup --desktop
+```
+
+Or manually add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 
 ```json
 {
@@ -254,7 +260,7 @@ Tools are automatically filtered at startup based on available credentials. If y
 |------|------|-------------|
 | `list_org_libraries` | cookie | All design system libraries in the org with sharing group info |
 
-### compound (6 tools)
+### compound (12 tools)
 
 Multi-step operations that aggregate data from several API calls.
 
@@ -266,6 +272,12 @@ Multi-step operations that aggregate data from several API calls.
 | `cleanup_stale_files` | either | Find files not modified in N days, optionally trash them (dry run by default) |
 | `organize_project` | cookie | Batch-move files into a target project |
 | `setup_project_structure` | cookie | Create multiple projects in a team from a plan |
+| `seat_optimization` | cookie | Identify inactive paid seats and calculate potential savings |
+| `permission_audit` | cookie | Audit who has access to a team or project, flag oversharing |
+| `branch_cleanup` | either | Find stale branches across a project, optionally archive (dry run by default) |
+| `offboard_user` | cookie | Audit + execute user departure: transfer files, revoke access, downgrade seat |
+| `onboard_user` | cookie | Batch invite to teams, share files, set seat type in one call |
+| `quarterly_design_ops_report` | cookie | Org-wide snapshot: seat utilization, billing, teams, library adoption |
 
 ## transport modes
 
@@ -323,7 +335,8 @@ src/
     org.ts              Org admin, billing, seats, domains via internal API (9 tools)
     teams.ts            Team CRUD (3 tools)
     libraries.ts        Design system libraries via internal API (1 tool)
-    compound.ts         Multi-step aggregation tools (6 tools)
+    compound.ts         Multi-step aggregation tools (9 tools)
+    compound-manager.ts Manager workflow tools (3 tools)
   types/
     figma.ts            Shared types (Toolset, AuthConfig, etc.)
 ```

package/dist/index.d.ts

@@ -16,4 +16,5 @@ import './tools/org.js';
 import './tools/libraries.js';
 import './tools/teams.js';
 import './tools/compound.js';
+import './tools/compound-manager.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -28,6 +28,7 @@ import './tools/org.js';
 import './tools/libraries.js';
 import './tools/teams.js';
 import './tools/compound.js';
+import './tools/compound-manager.js';
 const ALL_TOOLSETS = [
     'navigate', 'files', 'projects', 'permissions', 'org',
     'versions', 'branching', 'comments', 'export',

package/dist/setup.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { execSync, execFileSync } from 'child_process';
 import { createDecipheriv, pbkdf2Sync } from 'crypto';
-import { copyFileSync, unlinkSync, mkdtempSync, existsSync, rmdirSync, readFileSync } from 'fs';
+import { copyFileSync, unlinkSync, mkdtempSync, mkdirSync, existsSync, rmdirSync, readFileSync, writeFileSync } from 'fs';
 import { join } from 'path';
 import { tmpdir, homedir, platform } from 'os';
 import axios from 'axios';
@@ -294,8 +294,32 @@ function registerWithClaude(envVars) {
         return false;
     }
 }
+function registerWithDesktop(envVars) {
+    const configPath = platform() === 'win32'
+        ? join(process.env.APPDATA || join(homedir(), 'AppData/Roaming'), 'Claude/claude_desktop_config.json')
+        : join(homedir(), 'Library/Application Support/Claude/claude_desktop_config.json');
+    try {
+        let config = {};
+        if (existsSync(configPath)) {
+            config = JSON.parse(readFileSync(configPath, 'utf-8'));
+        }
+        if (!config.mcpServers)
+            config.mcpServers = {};
+        config.mcpServers.figmanage = {
+            command: 'npx',
+            args: ['-y', 'figmanage'],
+            env: envVars,
+        };
+        mkdirSync(join(configPath, '..'), { recursive: true });
+        writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 function printManualConfig(envVars) {
-    console.log('\nClaude CLI not found. Configure your MCP client manually.\n');
+    console.log('\nConfigure your MCP client manually.\n');
     console.log('Environment variables:');
     for (const [k, v] of Object.entries(envVars)) {
         const display = (k === 'FIGMA_AUTH_COOKIE' || k === 'FIGMA_PAT') ? '******' : v;
@@ -315,21 +339,25 @@ function printManualConfig(envVars) {
 function parseArgs() {
     const args = process.argv.slice(2);
     let noPrompt = false;
+    let desktop = false;
     let pat;
     for (let i = 0; i < args.length; i++) {
         if (args[i] === '--no-prompt') {
             noPrompt = true;
         }
+        else if (args[i] === '--desktop') {
+            desktop = true;
+        }
         else if (args[i] === '--pat' && i + 1 < args.length) {
             pat = args[++i];
         }
     }
-    return { noPrompt, pat };
+    return { noPrompt, desktop, pat };
 }
 // --- Main ---
 async function setup() {
     console.log('figmanage setup\n');
-    const { noPrompt, pat: patArg } = parseArgs();
+    const { noPrompt, desktop, pat: patArg } = parseArgs();
     const os = platform();
     // Build env vars to register
     const envVars = {};
@@ -351,8 +379,18 @@ async function setup() {
             process.exit(1);
         }
         // Register with whatever client is available
-        if (claudeCliAvailable()) {
-            console.log('\nRegistering with Claude...');
+        if (desktop) {
+            console.log('\nRegistering with Claude Desktop...');
+            if (registerWithDesktop(envVars)) {
+                console.log('  Credentials written to claude_desktop_config.json');
+                console.log('  Done. Restart Claude Desktop to use figmanage.');
+            }
+            else {
+                printManualConfig(envVars);
+            }
+        }
+        else if (claudeCliAvailable()) {
+            console.log('\nRegistering with Claude Code...');
             if (registerWithClaude(envVars)) {
                 console.log('  PAT stored in MCP server config');
                 console.log('  Done. Restart Claude Code to use figmanage.');
@@ -542,8 +580,19 @@ async function setup() {
         console.log(`FIGMA_ORG_ID=${orgId}`);
     if (pat)
         console.log('FIGMA_PAT=****** (stored in MCP server config)');
-    if (claudeCliAvailable()) {
-        console.log('\nRegistering with Claude...');
+    if (desktop) {
+        console.log('\nRegistering with Claude Desktop...');
+        if (registerWithDesktop(envVars)) {
+            console.log('  Credentials written to claude_desktop_config.json');
+            console.log('  Done. Restart Claude Desktop to use figmanage.');
+        }
+        else {
+            console.log('  Could not write config automatically.');
+            printManualConfig(envVars);
+        }
+    }
+    else if (claudeCliAvailable()) {
+        console.log('\nRegistering with Claude Code...');
         if (registerWithClaude(envVars)) {
             if (pat)
                 console.log('  PAT stored in MCP server config');

package/dist/tools/compound-manager.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=compound-manager.d.ts.map