@kendoo.agentdesk/agentdesk 0.6.6 → 0.6.8

package/README.md

@@ -2,17 +2,21 @@
 
 AI team orchestrator for [Claude Code](https://claude.ai/code). Run collaborative agent sessions from your terminal and watch them live on [agentdesk.live](https://agentdesk.live).
 
-AgentDesk spawns a team of 7 specialized AI agents inside Claude Code that collaborate on your tasks:
+AgentDesk spawns a team of AI agents inside Claude Code that collaborate on your tasks. The default team includes 7 built-in agents, and you can add custom agents to fit your workflow.
+
+### Built-in Agents
 
 | Agent | Role |
 |-------|------|
 | Jane | Product Lead — facilitates, clarifies requirements, coordinates the team |
-| Luna | UX/UI Designer — visual consistency, accessibility, interaction patterns |
-| Mark | Content Writer — copy, tone, user-facing text |
-| Sam | Architecture Auditor — code structure, separation of concerns |
 | Dennis | Senior Developer — implements the solution |
-| Bart | QA Engineer — edge cases, risks, acceptance criteria |
+| Sam | Architecture Auditor — code structure, separation of concerns |
+| Bart | QA Engineer — edge cases, risks, acceptance criteria, screenshots |
 | Vera | Test Engineer — unit tests, regression coverage |
+| Luna | UX/UI Designer — visual consistency, accessibility, interaction patterns |
+| Mark | Content Writer — copy, tone, user-facing text |
+
+You can also add **custom agents** (e.g., a Security Engineer or DevOps specialist) via project settings.
 
 ## Getting Started
 
@@ -22,7 +26,7 @@ AgentDesk spawns a team of 7 specialized AI agents inside Claude Code that colla
 npm i -g @kendoo.agentdesk/agentdesk
 ```
 
-Requires [Node.js](https://nodejs.org/) 18+.
+Requires [Claude Code](https://claude.ai/code) and [Node.js](https://nodejs.org/) 18+.
 
 ### 2. Sign in
 
@@ -38,7 +42,7 @@ Opens your browser to [agentdesk.live](https://agentdesk.live) where you sign up
 agentdesk init
 ```
 
-This detects your project, asks which task tracker you use (Linear, Jira, GitHub Issues, or none), and saves the config to `.agentdesk.json`.
+This detects your project, asks which task tracker you use (Linear, Jira, GitHub Issues, or none), and saves the config.
 
 ### 4. Run a team session
 
@@ -55,46 +59,7 @@ agentdesk team -d "Fix the checkout total calculation"
 agentdesk team -d "Add Google OAuth to the login page"
 ```
 
-Open [agentdesk.live](https://agentdesk.live) to watch the session live.
-
-## Configuration
-
-`agentdesk init` creates `.agentdesk.json` in your project root. You can also edit it manually:
-
-```json
-{
-  "tracker": "linear",
-  "linear": { "workspace": "your-workspace" }
-}
-```
-
-### Task trackers
-
-| Tracker | Config |
-|---------|--------|
-| Linear | `{ "tracker": "linear", "linear": { "workspace": "..." } }` |
-| Jira | `{ "tracker": "jira", "jira": { "baseUrl": "https://company.atlassian.net" } }` |
-| GitHub Issues | `{ "tracker": "github", "github": { "repo": "owner/repo" } }` |
-| None | No config needed — pass `-d "description"` when running a session |
-
-### Declaring project agents
-
-If your project has existing AI agents, bots, or automation, declare them so the team knows about them:
-
-```json
-{
-  "projectAgents": [
-    {
-      "name": "ReviewBot",
-      "role": "Auto-reviews PRs for security issues",
-      "when": "Triggers on every PR creation",
-      "how": "Comment /review on a PR to re-trigger"
-    }
-  ]
-}
-```
-
-AgentDesk also auto-discovers agents from `.claude/agents/`, `.claude/commands/`, `.mcp.json`, GitHub Actions workflows, Dependabot, and Renovate configs.
+Watch the session live at [agentdesk.live](https://agentdesk.live). Each session gets a deep link you can share.
 
 ## Commands
 
@@ -104,6 +69,7 @@ agentdesk logout                       Sign out and remove credentials
 agentdesk init                         Set up project and configure tracker
 agentdesk team <TASK-ID>               Run a team session on an existing task
 agentdesk team -d "..."                Describe what you want — task created automatically
+agentdesk update                       Update to the latest version
 ```
 
 ### Options
@@ -113,12 +79,57 @@ agentdesk team -d "..."                Describe what you want — task created a
 | `--description`, `-d` | Task description or requirements |
 | `--cwd` | Working directory (defaults to current) |
 
+## Configuration
+
+Settings can be managed in two ways:
+
+1. **Web UI** — go to [agentdesk.live](https://agentdesk.live), select a project, and click the gear icon to configure tracker, team composition, custom agents, commands, and instructions.
+2. **Local file** — `.agentdesk.json` in your project root. Local settings override server settings.
+
+The CLI fetches settings from the server at runtime. If the server is unreachable, it falls back to `.agentdesk.json`.
+
+### Task trackers
+
+| Tracker | Config |
+|---------|--------|
+| Linear | Workspace slug (e.g., `kendoo`) |
+| Jira | Base URL (e.g., `https://company.atlassian.net`) + project key |
+| GitHub Issues | Repository (e.g., `owner/repo`) |
+| None | No config needed — pass `-d "description"` when running a session |
+
+### Custom agents
+
+Add custom agents via your project settings at [agentdesk.live](https://agentdesk.live):
+
+1. Select your project and click the gear icon
+2. Under **Project Agents**, click "Add agent" and fill in the name, role, when, and how
+3. Under **Team Composition**, toggle the new agent on
+4. Save
+
+Custom agents participate in all phases alongside built-in agents — brainstorm, planning, execution, and review.
+
+You can also define them in `.agentdesk.json` as a local override if preferred.
+
+AgentDesk also auto-discovers agents from `.claude/agents/`, `.claude/commands/`, `.mcp.json`, GitHub Actions workflows, Dependabot, and Renovate configs.
+
 ## How It Works
 
 1. You run `agentdesk team TASK-ID` in your project directory
 2. AgentDesk detects your project type, reads `CLAUDE.md`, and discovers existing agents
-3. 7 AI agents collaborate on your task in structured phases: **Brainstorm** > **Planning** > **Execution** > **Review**
+3. The team collaborates in structured phases: **Intake** > **Brainstorm** > **Planning** > **Execution** > **Review**
 4. The session streams live to [agentdesk.live](https://agentdesk.live) where you can watch and send messages to the team
+5. For UI tasks, the team captures screenshots (desktop + mobile) and uploads them to your task tracker
+6. Token usage is tracked and displayed per session
+
+## Dashboard Features
+
+- **Live sessions** — watch agents collaborate in real-time
+- **Session deep links** — share a direct URL to any session
+- **Project settings** — configure tracker, team, custom agents, and instructions per project
+- **Account settings** — manage your API key and profile
+- **Agent roster** — see each agent's role, participation rate, tag breakdown, and phase involvement
+- **Token tracking** — input/output token counts per session
+- **Auto-reconnect** — CLI reconnects automatically if the connection drops
 
 ## Requirements
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kendoo.agentdesk/agentdesk",
-  "version": "0.6.6",
+  "version": "0.6.8",
   "description": "AI team orchestrator for Claude Code — run collaborative agent sessions from your terminal",
   "type": "module",
   "bin": {