From f019aa6f1d072c503c63c124b7076aaecdc784ae Mon Sep 17 00:00:00 2001 From: John Xie Date: Wed, 18 Nov 2026 14:45:19 -0800 Subject: [PATCH] docs(readme): Correct old names, stale facts and the default API host - Workspace DNA has three parts: Memory, Intelligence and Execution - Replace internal and old names with plain words and "Taskade Genesis" - Name the app gallery Taskade App Factory - Default TASKADE_API_URL to https://www.taskade.com: the bare host redirects, and the redirect turns the import POST into a GET (404) - Workspace URLs use /spaces/, not /ws/ - Add --clone to the fork step, list export.ts, note the export plan - Link the hosted MCP docs page instead of the endpoint (401 in a browser) --- README.md | 48 ++++++++++++++++++----------------- apps/hello-world.json | 2 +- manifest.json | 2 +- projects/getting-started.json | 2 +- projects/roadmap.json | 2 +- scripts/assemble.ts | 2 +- scripts/export.ts | 4 +-- scripts/import.ts | 4 +-- 8 files changed, 34 insertions(+), 32 deletions(-) diff --git a/README.md b/README.md index 412112b..f6624fd 100644 --- a/README.md +++ b/README.md @@ -6,22 +6,23 @@ ## What is Workspace DNA? -Every Taskade workspace is built from four types of DNA: +Workspace DNA has three parts: Memory, Intelligence and Execution. The app interface sits on top of them: | Layer | Folder | What it does | |-------|--------|-------------| | **Memory** | `projects/` | Structured data — task trees, checklists, notes | | **Intelligence** | `agents/` | AI agents with custom commands and personas | -| **Reflexes** | `automations/` | Trigger-action workflows connecting services | -| **Interface** | `apps/` | Genesis app UI — React components via Parade engine | +| **Execution** | `automations/` | Trigger-action workflows connecting services | +| **Interface** | `apps/` | Taskade Genesis app UI — React components that the app engine runs | -This repo contains one JSON file per DNA item — the same format that Taskade uses internally. No build toolchain required to understand or edit. +This repo contains one JSON file per DNA item — the same format that the Taskade bundle import and export API uses. No build toolchain required to understand or edit. ## Quick Start ```bash # 1. Fork this repo (or click "Use this template") -gh repo fork taskade/taskade-sample-app +gh repo fork taskade/taskade-sample-app --clone +cd taskade-sample-app # 2. Install dependencies npm install @@ -54,31 +55,32 @@ taskade-sample-app/ │ ├── getting-started.json # Onboarding checklist │ └── roadmap.json # Product roadmap with phases ├── apps/ -│ └── hello-world.json # Sample Genesis app (React + Tailwind) +│ └── hello-world.json # Sample Taskade Genesis app (React + Tailwind) ├── media/ │ └── icon.svg # App icon ├── scripts/ │ ├── assemble.ts # Combines folders → workspace.json │ ├── validate.ts # Validates against SpaceBundleData schema -│ └── import.ts # Uploads to Taskade via API +│ ├── import.ts # Uploads to Taskade via API +│ └── export.ts # Downloads a workspace via API └── dist/ # (generated) assembled bundle └── workspace.json ``` ## How It Maps to Taskade -The folder structure mirrors the Workspace tab in Taskade: +Each folder maps to one part of a Taskade workspace: ``` -GitHub Repo Taskade Workspace Tab -═══════════ ═════════════════════ -agents/*.json ──► [Agents] filter pill -automations/*.json ──► [Automations] filter pill -projects/*.json ──► [Projects] filter pill -apps/*.json ──► [Apps] Genesis app UI +GitHub Repo Taskade Workspace +═══════════ ═════════════════ +agents/*.json ──► AI agents +automations/*.json ──► Automations +projects/*.json ──► Projects +apps/*.json ──► Taskade Genesis app UI ``` -Each JSON file is the same data shape that Taskade's internal `SpaceBundleData` uses. You can: +Each JSON file is the same data shape that the Taskade bundle API uses (`SpaceBundleData` v1). You can: - **Export** a workspace from Taskade → get these JSON files - **Edit** the JSON files in any editor - **Import** back into Taskade → get a working workspace @@ -87,7 +89,7 @@ Each JSON file is the same data shape that Taskade's internal `SpaceBundleData` | Command | What it does | |---------|-------------| -| `npm run export` | Pull a workspace into local JSON files | +| `npm run export` | Pull a workspace into local JSON files (bundle export needs the Pro plan or higher, see [pricing](https://www.taskade.com/pricing)) | | `npm run validate` | Validates all JSON files against Taskade schemas | | `npm run assemble` | Combines all items into `dist/workspace.json` | | `npm run build` | Assemble + validate (both steps) | @@ -129,7 +131,7 @@ Each JSON file is the same data shape that Taskade's internal `SpaceBundleData` } ``` -4. **Add a Genesis app**: Create `apps/my-app.json` with a `FileSystemTree`: +4. **Add a Taskade Genesis app**: Create `apps/my-app.json` with a `FileSystemTree`: ```json { "src": { @@ -143,7 +145,7 @@ Each JSON file is the same data shape that Taskade's internal `SpaceBundleData` } } ``` - The file system tree mirrors the Parade base template structure. Each file node has `{ file: { contents: "..." } }` and directories use `{ directory: { ... } }`. + The file system tree mirrors the file structure of a Taskade Genesis app. Each file node has `{ file: { contents: "..." } }` and directories use `{ directory: { ... } }`. 5. Run `npm run build` to assemble and validate. @@ -151,9 +153,9 @@ Each JSON file is the same data shape that Taskade's internal `SpaceBundleData` | Variable | Required | Description | |----------|----------|-------------| -| `TASKADE_API_TOKEN` | For import | Personal Access Token (`tskdp_...`) | -| `TASKADE_WORKSPACE_ID` | For import | Target workspace ID | -| `TASKADE_API_URL` | No | API base URL (default: `https://taskade.com`) | +| `TASKADE_API_TOKEN` | For import and export | Personal Access Token (`tskdp_...`) | +| `TASKADE_WORKSPACE_ID` | For import and export | Target or source workspace ID | +| `TASKADE_API_URL` | No | API base URL (default: `https://www.taskade.com`) | Get your API token at [taskade.com/settings/api](https://www.taskade.com/settings/api). @@ -162,8 +164,8 @@ Get your API token at [taskade.com/settings/api](https://www.taskade.com/setting - [Build an app with Taskade Genesis](https://www.taskade.com/create) - [AI app builder](https://www.taskade.com/ai/apps) - [AI agents](https://www.taskade.com/ai/agents) -- [Community apps you can clone](https://www.taskade.com/apps) -- [Hosted MCP server](https://www.taskade.com/mcp) +- [Taskade App Factory: App Kits you can clone](https://www.taskade.com/apps) +- [Hosted MCP server](https://www.taskade.com/docs/mcp/hosted-mcp) at `https://www.taskade.com/mcp`, part of every paid plan - [Taskade API Docs](https://www.taskade.com/api/documentation/v1) - [Taskade MCP Server on GitHub](https://github.com/taskade/mcp) diff --git a/apps/hello-world.json b/apps/hello-world.json index 55fa7ac..4379b32 100644 --- a/apps/hello-world.json +++ b/apps/hello-world.json @@ -3,7 +3,7 @@ "directory": { "App.tsx": { "file": { - "contents": "import * as React from 'react';\nimport { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card';\nimport { Button } from '@/components/ui/button';\nimport { Badge } from '@/components/ui/badge';\n\nexport default function App() {\n const [count, setCount] = React.useState(0);\n\n return (\n
\n
\n \n \n Hello World\n \n A sample Genesis app built with Workspace DNA.\n \n \n \n
\n \n Genesis App\n
\n

\n This app was assembled from the taskade-sample-app template.\n Edit apps/hello-world.json to customize it.\n

\n
\n
\n
\n
\n );\n}\n" + "contents": "import * as React from 'react';\nimport { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card';\nimport { Button } from '@/components/ui/button';\nimport { Badge } from '@/components/ui/badge';\n\nexport default function App() {\n const [count, setCount] = React.useState(0);\n\n return (\n
\n
\n \n \n Hello World\n \n A sample Taskade Genesis app built with Workspace DNA.\n \n \n \n
\n \n Taskade Genesis App\n
\n

\n This app was assembled from the taskade-sample-app template.\n Edit apps/hello-world.json to customize it.\n

\n
\n
\n
\n
\n );\n}\n" } }, "main.tsx": { diff --git a/manifest.json b/manifest.json index ba4feb4..5fb1945 100644 --- a/manifest.json +++ b/manifest.json @@ -3,7 +3,7 @@ "name": "Taskade Sample App", "version": "1.0.0", "author": "taskade", - "description": "A sample Genesis app demonstrating Workspace DNA: agents, automations, and projects working together.", + "description": "A sample Taskade Genesis app demonstrating Workspace DNA: agents, automations, and projects working together.", "tags": ["sample", "getting-started", "genesis"], "icon": "media/icon.svg", "minPlatformVersion": "2025.1" diff --git a/projects/getting-started.json b/projects/getting-started.json index 51ba61f..09e87b0 100644 --- a/projects/getting-started.json +++ b/projects/getting-started.json @@ -28,7 +28,7 @@ "id": "overview-desc", "text": { "ops": [ - { "insert": "This project is part of a sample Genesis app. It demonstrates how Projects (Memory), Agents (Intelligence), and Automations (Reflexes) work together as Workspace DNA." }, + { "insert": "This project is part of a sample Taskade Genesis app. It demonstrates how Projects (Memory), Agents (Intelligence), and Automations (Execution) work together as Workspace DNA." }, { "insert": "\n", "attributes": { "paragraph": true } } ] }, diff --git a/projects/roadmap.json b/projects/roadmap.json index 88bfdcd..c51d24e 100644 --- a/projects/roadmap.json +++ b/projects/roadmap.json @@ -77,7 +77,7 @@ "id": "task-p2-1", "text": { "ops": [ - { "insert": "Publish to community gallery" }, + { "insert": "Publish to Taskade App Factory" }, { "insert": "\n", "attributes": { "paragraph": true } } ] }, diff --git a/scripts/assemble.ts b/scripts/assemble.ts index 0f45144..03870b1 100644 --- a/scripts/assemble.ts +++ b/scripts/assemble.ts @@ -86,7 +86,7 @@ for (const { name, data } of readJsonFiles('projects')) { }; } -// Apps (Genesis app file systems) +// Apps (Taskade Genesis app file systems) for (const { name, data } of readJsonFiles('apps')) { const id = `app-${name}`; items[id] = { diff --git a/scripts/export.ts b/scripts/export.ts index d257688..52a3f64 100644 --- a/scripts/export.ts +++ b/scripts/export.ts @@ -14,7 +14,7 @@ import * as fs from 'node:fs'; import * as path from 'node:path'; const ROOT = path.resolve(import.meta.dirname, '..'); -const API_BASE = process.env.TASKADE_API_URL ?? 'https://taskade.com'; +const API_BASE = process.env.TASKADE_API_URL ?? 'https://www.taskade.com'; const API_TOKEN = process.env.TASKADE_API_TOKEN; const WORKSPACE_ID = process.env.TASKADE_WORKSPACE_ID; @@ -26,7 +26,7 @@ if (!API_TOKEN) { if (!WORKSPACE_ID) { console.error('Error: TASKADE_WORKSPACE_ID environment variable is required.'); - console.error('Find your workspace ID in the workspace URL: https://taskade.com/ws/'); + console.error('Find your workspace ID in the workspace URL: https://www.taskade.com/spaces/'); process.exit(1); } diff --git a/scripts/import.ts b/scripts/import.ts index 76592d9..fc3544d 100644 --- a/scripts/import.ts +++ b/scripts/import.ts @@ -15,7 +15,7 @@ import * as fs from 'node:fs'; import * as path from 'node:path'; const ROOT = path.resolve(import.meta.dirname, '..'); -const API_BASE = process.env.TASKADE_API_URL ?? 'https://taskade.com'; +const API_BASE = process.env.TASKADE_API_URL ?? 'https://www.taskade.com'; const API_TOKEN = process.env.TASKADE_API_TOKEN; const WORKSPACE_ID = process.env.TASKADE_WORKSPACE_ID; @@ -27,7 +27,7 @@ if (!API_TOKEN) { if (!WORKSPACE_ID) { console.error('Error: TASKADE_WORKSPACE_ID environment variable is required.'); - console.error('Find your workspace ID in the workspace URL: https://taskade.com/ws/'); + console.error('Find your workspace ID in the workspace URL: https://www.taskade.com/spaces/'); process.exit(1); }