tokens-for-good 0.4.3 → 0.4.6

package/README.md

@@ -1,12 +1,12 @@
 # Tokens for Good
 
-Donate your spare AI tokens to research nonprofit organizations for [Fierce Philanthropy](https://fierce-philanthropy-directory.laravel.cloud)'s social impact directory. Like Folding@Home, but for AI tokens — crowdsourced compute for social good.
+Donate your spare AI tokens to research nonprofit organizations for [Fierce Philanthropy](https://tokensforgood.ai)'s social impact directory. Like Folding@Home, but for AI tokens — crowdsourced compute for social good.
 
-Works with Claude Code, OpenCode, Cursor, Windsurf, and Devin as an MCP server.
+Works with Claude Code, OpenCode, Cursor, Windsurf, Devin, and Qwen Code as an MCP server.
 
 ## Quickstart
 
-1. **Sign up** at [fierce-philanthropy-directory.laravel.cloud/contribute](https://fierce-philanthropy-directory.laravel.cloud/contribute) (GitHub OAuth, free) and copy your API key.
+1. **Sign up** at [tokensforgood.ai/contribute](https://tokensforgood.ai/contribute) (GitHub OAuth, free) and copy your API key.
 2. **Run init in your terminal:**
 
    ```bash
@@ -15,7 +15,7 @@ Works with Claude Code, OpenCode, Cursor, Windsurf, and Devin as an MCP server.
 
    init is interactive: it asks for your API key, the cadence you want (daily / weekly / hourly / one-off), and then writes everything — MCP config, SessionStart hook, `/tfg` and `/tfg-schedule` skills, and your preference — in one shot.
 
-3. **Open Claude Code.** Your first session acts on the cadence you picked automatically:
+3. **Open your AI coding tool.** Your first session acts on the cadence you picked automatically:
    - Scheduled → it sets up `/schedule` via the `/tfg-schedule` skill.
    - One-off → it kicks off a single research task via the `/tfg` skill.
 
@@ -58,6 +58,7 @@ Once installed, these are available to your AI via the MCP server:
 ## Non-Claude-Code platforms
 
 - **OpenCode** — `init` writes `~/.config/opencode/opencode.json` and prints a cron line you can paste into `crontab -e`.
+- **Qwen Code** — `init` writes `~/.qwen/settings.json` (preserving other keys) plus a `/tfg` slash command at `~/.qwen/commands/tfg.md`. For recurring runs, enable Qwen Code's experimental cron (`QWEN_CODE_ENABLE_CRON=1`) or use a system cron line.
 - **Cursor / Windsurf / Devin** — `init` writes the MCP config; automation requires platform-native scheduling.
 
 ## Contributing

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokens-for-good",
-  "version": "0.4.3",
+  "version": "0.4.6",
   "type": "module",
   "description": "Donate your spare AI tokens to research nonprofits for Fierce Philanthropy",
   "bin": {

package/pipeline/03-humanize/PROMPT.md

@@ -1,4 +1,4 @@
-# Step 3: Humanize — Claude Code Instructions
+# Step 3: Humanize — Instructions
 
 ## Inputs
 

package/skills/tfg.md

@@ -21,7 +21,7 @@ The user wants to complete one Tokens for Good research cycle.
 
 ## If something goes wrong
 
-- **`claim_org` returns an error about an API key** → run `npx tokens-for-good init` in terminal and restart Claude Code.
+- **`claim_org` returns an error about an API key** → run `npx tokens-for-good init` in terminal and restart your AI tool.
 - **A citation fails verification** → fix it or remove the claim it supported. Don't submit reports with broken citations.
 - **User interrupts mid-research** → the claim will auto-expire on the server side. No cleanup needed.
 

package/src/api-client.js

@@ -1,12 +1,12 @@
 // HTTP client for the Fierce Philanthropy coordination API
 
-const BASE_URL = process.env.FIERCE_API_URL || 'https://fierce-philanthropy-directory.laravel.cloud/api';
+const BASE_URL = process.env.FIERCE_API_URL || 'https://tokensforgood.ai/api';
 
 export class ApiClient {
   constructor(apiKey) {
     this.apiKey = apiKey;
     if (!apiKey) {
-      throw new Error('TFG_API_KEY environment variable is required. Get your key at https://fierce-philanthropy-directory.laravel.cloud/contribute');
+      throw new Error('TFG_API_KEY environment variable is required. Get your key at https://tokensforgood.ai/contribute');
     }
   }
 
@@ -86,4 +86,11 @@ export class ApiClient {
     return this.request('GET', '/research/impact');
   }
 
+  async getNextAction() {
+    return this.request('GET', '/research/next-action');
+  }
+
+  async enableSchedule() {
+    return this.request('POST', '/research/enable-schedule');
+  }
 }

package/src/cli.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 // CLI entry point for tokens-for-good.
 // Usage:

package/src/init.js

@@ -28,6 +28,7 @@ const PLATFORM_CHOICES = [
   { title: 'Cursor',       value: 'cursor' },
   { title: 'Windsurf',     value: 'windsurf' },
   { title: 'Devin',        value: 'devin' },
+  { title: 'Qwen Code',    value: 'qwen-code' },
 ];
 
 const onCancel = () => {
@@ -57,7 +58,7 @@ export async function runInit() {
   const { apiKey } = await prompts({
     type: 'password',
     name: 'apiKey',
-    message: 'Paste your TFG API key (get one at https://fierce-philanthropy-directory.laravel.cloud/contribute):',
+    message: 'Paste your TFG API key (get one at https://tokensforgood.ai/contribute):',
     validate: v => /^tfg_(live|test)_/.test((v || '').trim()) || 'Key should start with tfg_live_ or tfg_test_',
   }, { onCancel });
 
@@ -110,6 +111,9 @@ export async function runInit() {
     console.log(`✓ ${plans[2].label}`);
     writeSkillFile('tfg');
     console.log(`✓ ${plans[3].label}`);
+  } else if (platform === 'qwen-code') {
+    writeQwenCommand('tfg');
+    console.log(`✓ ${plans[1].label}`);
   }
 
   saveState({
@@ -137,6 +141,8 @@ function planWrites(platform) {
     plans.push({ label: `${settingsPath()}  (SessionStart hook)` });
     plans.push({ label: `${skillPath('tfg-schedule')}  (/tfg-schedule skill)` });
     plans.push({ label: `${skillPath('tfg')}  (/tfg skill)` });
+  } else if (platform === 'qwen-code') {
+    plans.push({ label: `${qwenCommandPath('tfg')}  (/tfg slash command)` });
   }
   plans.push({ label: `${statePath()}  (recorded choice)` });
   return plans;
@@ -149,26 +155,13 @@ function homeRelative(abs) {
 }
 
 function mcpConfigPath(platform) {
-  const abs = (() => {
-    switch (platform) {
-      case 'opencode':
-        return join(homedir(), '.config', 'opencode', 'opencode.json');
-      case 'cursor':
-        return join(process.cwd(), '.cursor', 'mcp.json');
-      case 'windsurf':
-        return join(homedir(), '.codeium', 'windsurf', 'mcp_config.json');
-      case 'devin':
-      case 'claude-code':
-      default:
-        return join(homedir(), '.mcp.json');
-    }
-  })();
-  return homeRelative(abs);
+  return homeRelative(absoluteMcpPath(platform));
 }
 
-function settingsPath()  { return homeRelative(join(homedir(), '.claude', 'settings.json')); }
-function skillPath(name) { return homeRelative(join(homedir(), '.claude', 'skills', name, 'SKILL.md')); }
-function statePath()     { return homeRelative(join(homedir(), '.tokens-for-good', 'state.json')); }
+function settingsPath()         { return homeRelative(join(homedir(), '.claude', 'settings.json')); }
+function skillPath(name)        { return homeRelative(join(homedir(), '.claude', 'skills', name, 'SKILL.md')); }
+function qwenCommandPath(name)  { return homeRelative(join(homedir(), '.qwen', 'commands', `${name}.md`)); }
+function statePath()            { return homeRelative(join(homedir(), '.tokens-for-good', 'state.json')); }
 
 // --- File writers ---
 
@@ -228,6 +221,8 @@ function absoluteMcpPath(platform) {
       return join(process.cwd(), '.cursor', 'mcp.json');
     case 'windsurf':
       return join(homedir(), '.codeium', 'windsurf', 'mcp_config.json');
+    case 'qwen-code':
+      return join(homedir(), '.qwen', 'settings.json');
     case 'devin':
     case 'claude-code':
     default:
@@ -293,6 +288,16 @@ function writeSkillFile(name) {
   writeFileSync(dst, readFileSync(src, 'utf-8'), 'utf-8');
 }
 
+// Qwen Code uses Gemini CLI's custom-command format: one .md per command at
+// ~/.qwen/commands/<name>.md. YAML frontmatter is supported; the body is the
+// command prompt. Our existing skill body works as-is.
+function writeQwenCommand(name) {
+  const src = join(PKG_ROOT, 'skills', `${name}.md`);
+  const dst = join(homedir(), '.qwen', 'commands', `${name}.md`);
+  ensureDir(dst);
+  writeFileSync(dst, readFileSync(src, 'utf-8'), 'utf-8');
+}
+
 // --- Closing guidance ---
 
 function printClosingGuidance(platform, flow, freq) {
@@ -309,13 +314,25 @@ function printClosingGuidance(platform, flow, freq) {
     if (flow === 'scheduled') {
       console.log(`MCP config written to ${mcpConfigPath('opencode')}.\n`);
       console.log('To run on a schedule, add this to your crontab (crontab -e):');
-      const cron = freq === 'hourly' ? '0 * * * *' : freq === 'weekly' ? '0 2 * * 1' : '0 2 * * *';
-      console.log(`  ${cron} cd /path/to/workspace && opencode run "Research a nonprofit org for Fierce Philanthropy using the tokens-for-good MCP tools."\n`);
+      console.log(`  ${cronExpression(freq)} cd /path/to/workspace && opencode run "Research a nonprofit org for Fierce Philanthropy using the tokens-for-good MCP tools."\n`);
     } else {
       console.log('MCP config written. In OpenCode run: "Research a nonprofit org for Fierce Philanthropy."\n');
     }
     return;
   }
+  if (platform === 'qwen-code') {
+    console.log(`MCP config written to ${mcpConfigPath('qwen-code')}.`);
+    console.log(`Slash command written to ${qwenCommandPath('tfg')}.`);
+    console.log('Restart Qwen Code, then run `/tfg` to research one org.');
+    if (flow === 'scheduled') {
+      console.log('\nFor recurring runs, either:');
+      console.log('  • Enable Qwen Code\'s experimental cron (set QWEN_CODE_ENABLE_CRON=1 and use the Cron tool / /loop), or');
+      console.log('  • Add a system cron line (crontab -e):');
+      console.log(`      ${cronExpression(freq)} cd /path/to/workspace && qwen --prompt "Run /tfg"`);
+    }
+    console.log('');
+    return;
+  }
   // cursor, windsurf, devin
   console.log(`MCP config written to ${mcpConfigPath(platform)}.`);
   console.log(`Restart ${platform} and run: "Research a nonprofit org for Fierce Philanthropy."`);
@@ -324,3 +341,9 @@ function printClosingGuidance(platform, flow, freq) {
   }
   console.log('');
 }
+
+function cronExpression(freq) {
+  if (freq === 'hourly') return '0 * * * *';
+  if (freq === 'weekly') return '0 2 * * 1';
+  return '0 2 * * *';
+}