From 0ff65b0b027d26305870f13c634ba9a9cff91f80 Mon Sep 17 00:00:00 2001 From: Lukas May Date: Thu, 5 Mar 2026 12:05:08 +0100 Subject: [PATCH] feat: Rename application from "Codewalk District" to "Codewalkers" Update all user-facing strings (HTML title, manifest, header logo, browser title updater), code comments, and documentation references. Folder name retained as-is. --- .planning/MILESTONES.md | 2 +- .planning/PROJECT.md | 2 +- .planning/REQUIREMENTS.md | 2 +- .planning/ROADMAP.md | 2 +- .planning/phases/16-frontend-scaffold/16-01-PLAN.md | 4 ++-- .planning/phases/16-frontend-scaffold/16-03-PLAN.md | 4 ++-- .planning/phases/16-frontend-scaffold/16-04-PLAN.md | 2 +- .planning/phases/16-frontend-scaffold/16-05-PLAN.md | 2 +- .planning/research/ARCHITECTURE.md | 4 ++-- .planning/research/FEATURES.md | 2 +- .planning/research/PITFALLS.md | 2 +- .planning/research/STACK.md | 2 +- .planning/research/SUMMARY.md | 4 ++-- CLAUDE.md | 2 +- README.md | 4 ++-- apps/server/bin/cw.ts | 2 +- apps/server/cli/index.ts | 2 +- apps/server/db/schema.ts | 2 +- apps/server/index.ts | 2 +- apps/web/index.html | 2 +- apps/web/public/manifest.json | 4 ++-- apps/web/src/components/BrowserTitleUpdater.tsx | 4 ++-- apps/web/src/hooks/index.ts | 2 +- apps/web/src/layouts/AppLayout.tsx | 12 +++++------- docs/architecture.md | 2 +- docs/archive/wireframes/initiative-dashboard.md | 2 +- docs/archive/wireframes/initiative-detail.md | 2 +- docs/logging.md | 2 +- docs/wireframes/README.md | 2 +- docs/wireframes/app-layout.md | 2 +- docs/wireframes/v2/README.md | 2 +- docs/wireframes/v2/app-layout.md | 6 +++--- docs/wireframes/v2/theme.md | 2 +- 33 files changed, 46 insertions(+), 48 deletions(-) diff --git a/.planning/MILESTONES.md b/.planning/MILESTONES.md index 74c3fe6..eeac010 100644 --- a/.planning/MILESTONES.md +++ b/.planning/MILESTONES.md @@ -1,4 +1,4 @@ -# Project Milestones: Codewalk District +# Project Milestones: Codewalkers ## v1.3 Parallel Execution & UI Design (Shipped: 2026-02-02) diff --git a/.planning/PROJECT.md b/.planning/PROJECT.md index 0215b2a..d5c0128 100644 --- a/.planning/PROJECT.md +++ b/.planning/PROJECT.md @@ -1,4 +1,4 @@ -# Codewalk District +# Codewalkers ## What This Is diff --git a/.planning/REQUIREMENTS.md b/.planning/REQUIREMENTS.md index efc9ea1..804da2f 100644 --- a/.planning/REQUIREMENTS.md +++ b/.planning/REQUIREMENTS.md @@ -1,4 +1,4 @@ -# Requirements: Codewalk District +# Requirements: Codewalkers **Defined:** 2026-01-30 **Core Value:** Coordinate multiple Claude Code agents without losing track or stepping on each other. diff --git a/.planning/ROADMAP.md b/.planning/ROADMAP.md index 6e1e097..fb4912e 100644 --- a/.planning/ROADMAP.md +++ b/.planning/ROADMAP.md @@ -1,4 +1,4 @@ -# Roadmap: Codewalk District +# Roadmap: Codewalkers ## Overview diff --git a/.planning/phases/16-frontend-scaffold/16-01-PLAN.md b/.planning/phases/16-frontend-scaffold/16-01-PLAN.md index 2131eac..decfb6a 100644 --- a/.planning/phases/16-frontend-scaffold/16-01-PLAN.md +++ b/.planning/phases/16-frontend-scaffold/16-01-PLAN.md @@ -44,7 +44,7 @@ Output: A working `packages/web/` directory with Vite dev server, Tailwind CSS, - `packages/web/tsconfig.app.json` targeting ES2020, module ESNext, moduleResolution bundler, strict mode, jsx react-jsx, include `src`. - `packages/web/index.html` standard Vite entry pointing to `/src/main.tsx`. - `packages/web/src/main.tsx` rendering `` into `#root`. - - `packages/web/src/App.tsx` minimal component returning `
Codewalk District
`. + - `packages/web/src/App.tsx` minimal component returning `
Codewalkers
`. 3. Update root `package.json`: - Add `"workspaces": ["packages/*"]` for npm workspaces. @@ -118,7 +118,7 @@ npm run dev:web starts dev server (verify it starts, then kill). - `@/` → `./src/` (standard shadcn convention) - Install `@types/node` as dev dependency for path resolution in vite config. -7. Update `packages/web/src/App.tsx` to use a Tailwind class (e.g., `
Codewalk District
`) to verify Tailwind works. +7. Update `packages/web/src/App.tsx` to use a Tailwind class (e.g., `
Codewalkers
`) to verify Tailwind works. 8. Run `npm install` from root after adding dependencies. diff --git a/.planning/phases/16-frontend-scaffold/16-03-PLAN.md b/.planning/phases/16-frontend-scaffold/16-03-PLAN.md index 97977d8..bc76569 100644 --- a/.planning/phases/16-frontend-scaffold/16-03-PLAN.md +++ b/.planning/phases/16-frontend-scaffold/16-03-PLAN.md @@ -11,7 +11,7 @@ autonomous: true Wire tRPC React Query client to connect the frontend to the existing backend server. -Purpose: Enable type-safe data fetching from the Codewalk District backend. All subsequent UI screens (dashboard, detail, inbox) will use these tRPC hooks for data. +Purpose: Enable type-safe data fetching from the Codewalkers backend. All subsequent UI screens (dashboard, detail, inbox) will use these tRPC hooks for data. Output: Working tRPC client with React Query provider, connected to backend via Vite dev proxy. @@ -126,7 +126,7 @@ Output: Working tRPC client with React Query provider, connected to backend via return (
-

Codewalk District

+

Codewalkers

Server: {health.data?.status ?? 'connecting...'}

diff --git a/.planning/phases/16-frontend-scaffold/16-04-PLAN.md b/.planning/phases/16-frontend-scaffold/16-04-PLAN.md index 9630266..a7f3918 100644 --- a/.planning/phases/16-frontend-scaffold/16-04-PLAN.md +++ b/.planning/phases/16-frontend-scaffold/16-04-PLAN.md @@ -194,7 +194,7 @@ Component files exist in packages/web/src/components/ui/. Initiatives Agents Tasks Settings ``` Implementation: - - Header with app title "Codewalk District" on the left + - Header with app title "Codewalkers" on the left - "New Initiative" button on the right (placeholder handler for now) - Navigation tabs: Initiatives (links to /initiatives), Inbox (links to /inbox) - Skip "Agents", "Tasks", "Settings" tabs for now — not in Phase 16-19 scope. Include them as disabled/greyed out. diff --git a/.planning/phases/16-frontend-scaffold/16-05-PLAN.md b/.planning/phases/16-frontend-scaffold/16-05-PLAN.md index f5211c5..49f2fb6 100644 --- a/.planning/phases/16-frontend-scaffold/16-05-PLAN.md +++ b/.planning/phases/16-frontend-scaffold/16-05-PLAN.md @@ -58,7 +58,7 @@ All three commands succeed with zero errors. 1. Start backend: `cw --server` (or however the server starts) 2. Start frontend: `npm run dev:web` 3. Visit: http://localhost:5173 (Vite default port) - 4. Verify: Navigation header shows "Codewalk District" with nav tabs + 4. Verify: Navigation header shows "Codewalkers" with nav tabs 5. Click "Initiatives" tab → should show dashboard stub 6. Click "Inbox" tab → should show inbox stub 7. Verify: Tailwind styling renders (text should be styled, not raw HTML) diff --git a/.planning/research/ARCHITECTURE.md b/.planning/research/ARCHITECTURE.md index 0f7e65f..2f88f00 100644 --- a/.planning/research/ARCHITECTURE.md +++ b/.planning/research/ARCHITECTURE.md @@ -9,7 +9,7 @@ ## System Overview ``` - Codewalk District Architecture + Codewalkers Architecture ================================================================================ +------------------+ @@ -1044,7 +1044,7 @@ const container = createContainer(); program .name('cw') - .description('Codewalk District - Multi-agent workspace orchestrator') + .description('Codewalkers - Multi-agent workspace orchestrator') .version('0.1.0'); program diff --git a/.planning/research/FEATURES.md b/.planning/research/FEATURES.md index e7dd292..07ef12a 100644 --- a/.planning/research/FEATURES.md +++ b/.planning/research/FEATURES.md @@ -1,4 +1,4 @@ -# Feature Research: Codewalk District +# Feature Research: Codewalkers ## Metadata - **Domain**: Multi-agent orchestration / Developer tooling diff --git a/.planning/research/PITFALLS.md b/.planning/research/PITFALLS.md index 126534b..f32faf6 100644 --- a/.planning/research/PITFALLS.md +++ b/.planning/research/PITFALLS.md @@ -1,4 +1,4 @@ -# Codewalk District: Critical Pitfalls Reference +# Codewalkers: Critical Pitfalls Reference - **Domain:** Multi-agent orchestration / Developer tooling - **Researched:** 2026-01-30 diff --git a/.planning/research/STACK.md b/.planning/research/STACK.md index 1dbd35a..716f8dc 100644 --- a/.planning/research/STACK.md +++ b/.planning/research/STACK.md @@ -149,7 +149,7 @@ const program = new Command(); program .name('cw') - .description('Codewalk District - Multi-agent orchestration') + .description('Codewalkers - Multi-agent orchestration') .version('0.1.0'); program diff --git a/.planning/research/SUMMARY.md b/.planning/research/SUMMARY.md index 7f8f187..fa6ce30 100644 --- a/.planning/research/SUMMARY.md +++ b/.planning/research/SUMMARY.md @@ -1,13 +1,13 @@ # Project Research Summary -**Project:** Codewalk District +**Project:** Codewalkers **Domain:** Multi-agent orchestration / Developer tooling **Researched:** 2026-01-30 **Confidence:** HIGH ## Executive Summary -Codewalk District enters a space where the basic problem (running multiple Claude Code agents in parallel) is already solved by tools like Claude Squad, par, and Claude Flow. The differentiation opportunity isn't in parallel execution—that's table stakes now. The gap is in **coordination quality**: preventing conflicts before they happen, making review manageable, and keeping the developer in control without drowning in context switches. +Codewalkers enters a space where the basic problem (running multiple Claude Code agents in parallel) is already solved by tools like Claude Squad, par, and Claude Flow. The differentiation opportunity isn't in parallel execution—that's table stakes now. The gap is in **coordination quality**: preventing conflicts before they happen, making review manageable, and keeping the developer in control without drowning in context switches. The recommended approach is a TypeScript CLI with embedded tRPC server, SQLite persistence, and hexagonal architecture. Skip Redis/BullMQ—SQLite with WAL mode handles 10-15k tasks/second locally. Use Commander.js (not oclif), Drizzle ORM with better-sqlite3, and execa for process spawning. The modular monolith structure with clear port/adapter boundaries sets up future evolution without rewrites. diff --git a/CLAUDE.md b/CLAUDE.md index 7b01e7b..5f9f778 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,4 +1,4 @@ -# Codewalk District +# Codewalkers Multi-agent workspace for orchestrating multiple AI coding agents working in parallel on a shared codebase. diff --git a/README.md b/README.md index 68935f5..8bbe58d 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,8 @@ -# Codewalk District +# Codewalkers # Project concept -Codewalk district is a multi-agent workspace inspired by gastown. It works differently in the following ways: +Codewalkers is a multi-agent workspace inspired by gastown. It works differently in the following ways: * Subagents (e.g. Workers) that handle tasks run in -p mode and respond with a clear json schema * One cw (codewalk) web server is running that is also managing the agents * There shall be a clear post worktree setup hook that by default copies files (e.g. .env files) prepared inside a dedicated folder in the Project diff --git a/apps/server/bin/cw.ts b/apps/server/bin/cw.ts index 8e8d605..8c37c7c 100644 --- a/apps/server/bin/cw.ts +++ b/apps/server/bin/cw.ts @@ -1,6 +1,6 @@ #!/usr/bin/env node /** - * Codewalk District CLI Entry Point + * Codewalkers CLI Entry Point * * Users can install globally via: * - npm link (during development) diff --git a/apps/server/cli/index.ts b/apps/server/cli/index.ts index f276ff7..34c37bc 100644 --- a/apps/server/cli/index.ts +++ b/apps/server/cli/index.ts @@ -1,5 +1,5 @@ /** - * Codewalk District CLI + * Codewalkers CLI * * Commander-based CLI with help system and version display. * Supports server mode via --server flag. diff --git a/apps/server/db/schema.ts b/apps/server/db/schema.ts index 7cd72c9..def2870 100644 --- a/apps/server/db/schema.ts +++ b/apps/server/db/schema.ts @@ -1,5 +1,5 @@ /** - * Database schema for Codewalk District. + * Database schema for Codewalkers. * * Defines the three-level task hierarchy: * - Initiative: Top-level project diff --git a/apps/server/index.ts b/apps/server/index.ts index b2fdc76..af3c6e6 100644 --- a/apps/server/index.ts +++ b/apps/server/index.ts @@ -1,5 +1,5 @@ /** - * Codewalk District - Library Entry Point + * Codewalkers - Library Entry Point * * Multi-agent workspace for orchestrating multiple Claude Code agents. */ diff --git a/apps/web/index.html b/apps/web/index.html index 624703d..6c7672a 100644 --- a/apps/web/index.html +++ b/apps/web/index.html @@ -3,7 +3,7 @@ - Codewalk District + Codewalkers diff --git a/apps/web/public/manifest.json b/apps/web/public/manifest.json index 23a9b68..a0e35bb 100644 --- a/apps/web/public/manifest.json +++ b/apps/web/public/manifest.json @@ -1,6 +1,6 @@ { - "name": "Codewalk District", - "short_name": "Codewalk", + "name": "Codewalkers", + "short_name": "Codewalkers", "icons": [ { "src": "/icon-dark-192.png", diff --git a/apps/web/src/components/BrowserTitleUpdater.tsx b/apps/web/src/components/BrowserTitleUpdater.tsx index b507cf7..6f37daf 100644 --- a/apps/web/src/components/BrowserTitleUpdater.tsx +++ b/apps/web/src/components/BrowserTitleUpdater.tsx @@ -15,8 +15,8 @@ export function BrowserTitleUpdater() { if (runningCount > 0) parts.push(`${runningCount} running`); document.title = parts.length > 0 - ? `(${parts.join(", ")}) Codewalk District` - : "Codewalk District"; + ? `(${parts.join(", ")}) Codewalkers` + : "Codewalkers"; }, [runningCount, questionsCount]); return null; diff --git a/apps/web/src/hooks/index.ts b/apps/web/src/hooks/index.ts index c8b4f53..8d0cbdd 100644 --- a/apps/web/src/hooks/index.ts +++ b/apps/web/src/hooks/index.ts @@ -1,5 +1,5 @@ /** - * Shared React hooks for the Codewalk District frontend. + * Shared React hooks for the Codewalkers frontend. * * This module provides reusable hooks for common patterns like * debouncing, subscription management, and agent interactions. diff --git a/apps/web/src/layouts/AppLayout.tsx b/apps/web/src/layouts/AppLayout.tsx index b24dc12..6c0df56 100644 --- a/apps/web/src/layouts/AppLayout.tsx +++ b/apps/web/src/layouts/AppLayout.tsx @@ -36,13 +36,11 @@ export function AppLayout({ children, onOpenCommandPalette, connectionState }: A
{/* Left: Logo + Nav */}
- - - CW - - - Codewalk - District + + + + + Codewalkers