@kendoo.agentdesk/agentdesk 0.16.1 → 0.16.3

package/CHANGELOG.md

@@ -8,6 +8,16 @@ All user-facing changes to AgentDesk. Each entry is tagged:
 
 Internal refactors, infrastructure changes, and architectural notes are not listed here.
 
+## [0.16.3] — 2026-04-18
+
+### Changed
+- `[UI]` Docs and Guide pages updated to reflect the new tracker-setup flow: dedicated-user vs personal-account tradeoff, verify-and-echo step, config sync behavior, and the identity-badge field. README aligned with the same copy.
+
+## [0.16.2] — 2026-04-18
+
+### Added
+- `[Both]` Optional "Identity badge" field per project — a display name shown wherever AgentDesk identifies itself. Useful if you've set up a dedicated tracker user and want a consistent label across the dashboard. Empty by default; agents keep their role-based badges.
+
 ## [0.16.1] — 2026-04-18
 
 ### Added

package/README.md

@@ -43,7 +43,11 @@ 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.
+A guided wizard walks you through it: picks up your project type, asks which task tracker you use (Linear, Jira, GitHub Issues, or none), shows the tradeoff between a **dedicated AgentDesk user** and your personal account with step-by-step setup for either, verifies the credentials, echoes "Posting as: …" so you can confirm which identity will appear on tickets, then writes `.agentdesk.json`.
+
+Re-running `agentdesk init` in a project that already has config offers a "tracker only" shortcut. Use `agentdesk init --quick` to skip the narrative copy for scripted setups.
+
+`.agentdesk.json` is kept in sync with the server: every CLI run fetches the authoritative config and rewrites the local file as a credential-free snapshot. Credentials live only on the server, encrypted. If a local edit disagreed with the server's value, a one-line warning lists the overridden fields.
 
 ### 4. Run a team session
 
@@ -89,9 +93,9 @@ agentdesk update                       Update to the latest version
 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.
+2. **Local file** — `.agentdesk.json` in your project root. Acts as a credential-free cache of the server config, rewritten on every CLI run. If the server is unreachable, `.agentdesk.json` is used as-is (and never mutated).
 
-The CLI fetches settings from the server at runtime. If the server is unreachable, it falls back to `.agentdesk.json`.
+The server is the source of truth. If you edit `.agentdesk.json` directly while the server has a different value for the same field, the server wins and the CLI prints a one-line warning listing the overridden fields so you notice. To push local edits back up, re-run `agentdesk init` (the wizard writes to the server).
 
 ### Task trackers
 

package/cli/config.mjs

@@ -27,6 +27,10 @@ const DEFAULTS = {
   // (sonnet for INTAKE/PLAN/EXECUTION, haiku for REVIEW/SUMMARY).
   phaseModels: {},
   instructions: null,
+  // Optional display name shown wherever AgentDesk identifies itself (UI,
+  // future tracker-comment prefixes). Leave null to fall back to agent
+  // per-role badges and the tracker's own username for the credential.
+  identityBadge: null,
 };
 
 // Fields that must never be written to .agentdesk.json. Credentials live only

package/package.json

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