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.
This commit is contained in:
@@ -1,4 +1,4 @@
|
|||||||
# Project Milestones: Codewalk District
|
# Project Milestones: Codewalkers
|
||||||
|
|
||||||
## v1.3 Parallel Execution & UI Design (Shipped: 2026-02-02)
|
## v1.3 Parallel Execution & UI Design (Shipped: 2026-02-02)
|
||||||
|
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
# Codewalk District
|
# Codewalkers
|
||||||
|
|
||||||
## What This Is
|
## What This Is
|
||||||
|
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
# Requirements: Codewalk District
|
# Requirements: Codewalkers
|
||||||
|
|
||||||
**Defined:** 2026-01-30
|
**Defined:** 2026-01-30
|
||||||
**Core Value:** Coordinate multiple Claude Code agents without losing track or stepping on each other.
|
**Core Value:** Coordinate multiple Claude Code agents without losing track or stepping on each other.
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
# Roadmap: Codewalk District
|
# Roadmap: Codewalkers
|
||||||
|
|
||||||
## Overview
|
## Overview
|
||||||
|
|
||||||
|
|||||||
@@ -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/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/index.html` standard Vite entry pointing to `/src/main.tsx`.
|
||||||
- `packages/web/src/main.tsx` rendering `<App />` into `#root`.
|
- `packages/web/src/main.tsx` rendering `<App />` into `#root`.
|
||||||
- `packages/web/src/App.tsx` minimal component returning `<div>Codewalk District</div>`.
|
- `packages/web/src/App.tsx` minimal component returning `<div>Codewalkers</div>`.
|
||||||
|
|
||||||
3. Update root `package.json`:
|
3. Update root `package.json`:
|
||||||
- Add `"workspaces": ["packages/*"]` for npm workspaces.
|
- 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)
|
- `@/` → `./src/` (standard shadcn convention)
|
||||||
- Install `@types/node` as dev dependency for path resolution in vite config.
|
- 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., `<div className="text-2xl font-bold p-8">Codewalk District</div>`) to verify Tailwind works.
|
7. Update `packages/web/src/App.tsx` to use a Tailwind class (e.g., `<div className="text-2xl font-bold p-8">Codewalkers</div>`) to verify Tailwind works.
|
||||||
|
|
||||||
8. Run `npm install` from root after adding dependencies.
|
8. Run `npm install` from root after adding dependencies.
|
||||||
</action>
|
</action>
|
||||||
|
|||||||
@@ -11,7 +11,7 @@ autonomous: true
|
|||||||
<objective>
|
<objective>
|
||||||
Wire tRPC React Query client to connect the frontend to the existing backend server.
|
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.
|
Output: Working tRPC client with React Query provider, connected to backend via Vite dev proxy.
|
||||||
</objective>
|
</objective>
|
||||||
|
|
||||||
@@ -126,7 +126,7 @@ Output: Working tRPC client with React Query provider, connected to backend via
|
|||||||
|
|
||||||
return (
|
return (
|
||||||
<div className="p-8">
|
<div className="p-8">
|
||||||
<h1 className="text-2xl font-bold">Codewalk District</h1>
|
<h1 className="text-2xl font-bold">Codewalkers</h1>
|
||||||
<p className="text-muted-foreground mt-2">
|
<p className="text-muted-foreground mt-2">
|
||||||
Server: {health.data?.status ?? 'connecting...'}
|
Server: {health.data?.status ?? 'connecting...'}
|
||||||
</p>
|
</p>
|
||||||
|
|||||||
@@ -194,7 +194,7 @@ Component files exist in packages/web/src/components/ui/.
|
|||||||
Initiatives Agents Tasks Settings
|
Initiatives Agents Tasks Settings
|
||||||
```
|
```
|
||||||
Implementation:
|
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)
|
- "New Initiative" button on the right (placeholder handler for now)
|
||||||
- Navigation tabs: Initiatives (links to /initiatives), Inbox (links to /inbox)
|
- 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.
|
- Skip "Agents", "Tasks", "Settings" tabs for now — not in Phase 16-19 scope. Include them as disabled/greyed out.
|
||||||
|
|||||||
@@ -58,7 +58,7 @@ All three commands succeed with zero errors.
|
|||||||
1. Start backend: `cw --server` (or however the server starts)
|
1. Start backend: `cw --server` (or however the server starts)
|
||||||
2. Start frontend: `npm run dev:web`
|
2. Start frontend: `npm run dev:web`
|
||||||
3. Visit: http://localhost:5173 (Vite default port)
|
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
|
5. Click "Initiatives" tab → should show dashboard stub
|
||||||
6. Click "Inbox" tab → should show inbox stub
|
6. Click "Inbox" tab → should show inbox stub
|
||||||
7. Verify: Tailwind styling renders (text should be styled, not raw HTML)
|
7. Verify: Tailwind styling renders (text should be styled, not raw HTML)
|
||||||
|
|||||||
@@ -9,7 +9,7 @@
|
|||||||
## System Overview
|
## System Overview
|
||||||
|
|
||||||
```
|
```
|
||||||
Codewalk District Architecture
|
Codewalkers Architecture
|
||||||
================================================================================
|
================================================================================
|
||||||
|
|
||||||
+------------------+
|
+------------------+
|
||||||
@@ -1044,7 +1044,7 @@ const container = createContainer();
|
|||||||
|
|
||||||
program
|
program
|
||||||
.name('cw')
|
.name('cw')
|
||||||
.description('Codewalk District - Multi-agent workspace orchestrator')
|
.description('Codewalkers - Multi-agent workspace orchestrator')
|
||||||
.version('0.1.0');
|
.version('0.1.0');
|
||||||
|
|
||||||
program
|
program
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
# Feature Research: Codewalk District
|
# Feature Research: Codewalkers
|
||||||
|
|
||||||
## Metadata
|
## Metadata
|
||||||
- **Domain**: Multi-agent orchestration / Developer tooling
|
- **Domain**: Multi-agent orchestration / Developer tooling
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
# Codewalk District: Critical Pitfalls Reference
|
# Codewalkers: Critical Pitfalls Reference
|
||||||
|
|
||||||
- **Domain:** Multi-agent orchestration / Developer tooling
|
- **Domain:** Multi-agent orchestration / Developer tooling
|
||||||
- **Researched:** 2026-01-30
|
- **Researched:** 2026-01-30
|
||||||
|
|||||||
@@ -149,7 +149,7 @@ const program = new Command();
|
|||||||
|
|
||||||
program
|
program
|
||||||
.name('cw')
|
.name('cw')
|
||||||
.description('Codewalk District - Multi-agent orchestration')
|
.description('Codewalkers - Multi-agent orchestration')
|
||||||
.version('0.1.0');
|
.version('0.1.0');
|
||||||
|
|
||||||
program
|
program
|
||||||
|
|||||||
@@ -1,13 +1,13 @@
|
|||||||
# Project Research Summary
|
# Project Research Summary
|
||||||
|
|
||||||
**Project:** Codewalk District
|
**Project:** Codewalkers
|
||||||
**Domain:** Multi-agent orchestration / Developer tooling
|
**Domain:** Multi-agent orchestration / Developer tooling
|
||||||
**Researched:** 2026-01-30
|
**Researched:** 2026-01-30
|
||||||
**Confidence:** HIGH
|
**Confidence:** HIGH
|
||||||
|
|
||||||
## Executive Summary
|
## 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.
|
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.
|
||||||
|
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
# Codewalk District
|
# Codewalkers
|
||||||
|
|
||||||
Multi-agent workspace for orchestrating multiple AI coding agents working in parallel on a shared codebase.
|
Multi-agent workspace for orchestrating multiple AI coding agents working in parallel on a shared codebase.
|
||||||
|
|
||||||
|
|||||||
@@ -1,8 +1,8 @@
|
|||||||
# Codewalk District
|
# Codewalkers
|
||||||
|
|
||||||
# Project concept
|
# 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
|
* 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
|
* 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
|
* 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
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
#!/usr/bin/env node
|
#!/usr/bin/env node
|
||||||
/**
|
/**
|
||||||
* Codewalk District CLI Entry Point
|
* Codewalkers CLI Entry Point
|
||||||
*
|
*
|
||||||
* Users can install globally via:
|
* Users can install globally via:
|
||||||
* - npm link (during development)
|
* - npm link (during development)
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
/**
|
/**
|
||||||
* Codewalk District CLI
|
* Codewalkers CLI
|
||||||
*
|
*
|
||||||
* Commander-based CLI with help system and version display.
|
* Commander-based CLI with help system and version display.
|
||||||
* Supports server mode via --server flag.
|
* Supports server mode via --server flag.
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
/**
|
/**
|
||||||
* Database schema for Codewalk District.
|
* Database schema for Codewalkers.
|
||||||
*
|
*
|
||||||
* Defines the three-level task hierarchy:
|
* Defines the three-level task hierarchy:
|
||||||
* - Initiative: Top-level project
|
* - Initiative: Top-level project
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
/**
|
/**
|
||||||
* Codewalk District - Library Entry Point
|
* Codewalkers - Library Entry Point
|
||||||
*
|
*
|
||||||
* Multi-agent workspace for orchestrating multiple Claude Code agents.
|
* Multi-agent workspace for orchestrating multiple Claude Code agents.
|
||||||
*/
|
*/
|
||||||
|
|||||||
@@ -3,7 +3,7 @@
|
|||||||
<head>
|
<head>
|
||||||
<meta charset="UTF-8" />
|
<meta charset="UTF-8" />
|
||||||
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||||||
<title>Codewalk District</title>
|
<title>Codewalkers</title>
|
||||||
<link rel="icon" href="/favicon.ico" sizes="48x48">
|
<link rel="icon" href="/favicon.ico" sizes="48x48">
|
||||||
<link rel="icon" href="/icon.svg" type="image/svg+xml">
|
<link rel="icon" href="/icon.svg" type="image/svg+xml">
|
||||||
<link rel="apple-touch-icon" href="/icon-dark-180.png">
|
<link rel="apple-touch-icon" href="/icon-dark-180.png">
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "Codewalk District",
|
"name": "Codewalkers",
|
||||||
"short_name": "Codewalk",
|
"short_name": "Codewalkers",
|
||||||
"icons": [
|
"icons": [
|
||||||
{
|
{
|
||||||
"src": "/icon-dark-192.png",
|
"src": "/icon-dark-192.png",
|
||||||
|
|||||||
@@ -15,8 +15,8 @@ export function BrowserTitleUpdater() {
|
|||||||
if (runningCount > 0) parts.push(`${runningCount} running`);
|
if (runningCount > 0) parts.push(`${runningCount} running`);
|
||||||
|
|
||||||
document.title = parts.length > 0
|
document.title = parts.length > 0
|
||||||
? `(${parts.join(", ")}) Codewalk District`
|
? `(${parts.join(", ")}) Codewalkers`
|
||||||
: "Codewalk District";
|
: "Codewalkers";
|
||||||
}, [runningCount, questionsCount]);
|
}, [runningCount, questionsCount]);
|
||||||
|
|
||||||
return null;
|
return null;
|
||||||
|
|||||||
@@ -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
|
* This module provides reusable hooks for common patterns like
|
||||||
* debouncing, subscription management, and agent interactions.
|
* debouncing, subscription management, and agent interactions.
|
||||||
|
|||||||
@@ -36,13 +36,11 @@ export function AppLayout({ children, onOpenCommandPalette, connectionState }: A
|
|||||||
<div className="flex h-12 items-center justify-between px-5">
|
<div className="flex h-12 items-center justify-between px-5">
|
||||||
{/* Left: Logo + Nav */}
|
{/* Left: Logo + Nav */}
|
||||||
<div className="flex items-center gap-6">
|
<div className="flex items-center gap-6">
|
||||||
<Link to="/initiatives" className="flex items-center gap-2.5">
|
<Link to="/initiatives" className="flex items-center gap-2">
|
||||||
<span className="inline-flex h-7 w-7 items-center justify-center rounded bg-primary text-[11px] font-bold text-primary-foreground shadow-sm ring-1 ring-primary/20">
|
<img src="/icon-dark-48.png" alt="" className="h-7 w-7 dark:hidden" />
|
||||||
CW
|
<img src="/icon-light-48.png" alt="" className="hidden h-7 w-7 dark:block" />
|
||||||
</span>
|
<span className="hidden font-display font-bold tracking-tight sm:inline">
|
||||||
<span className="hidden items-baseline gap-1 sm:inline-flex">
|
Codewalkers
|
||||||
<span className="font-display font-bold tracking-tight">Codewalk</span>
|
|
||||||
<span className="font-display font-medium tracking-tight text-muted-foreground">District</span>
|
|
||||||
</span>
|
</span>
|
||||||
</Link>
|
</Link>
|
||||||
<nav className="flex items-center gap-1">
|
<nav className="flex items-center gap-1">
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
# Architecture Overview
|
# Architecture Overview
|
||||||
|
|
||||||
Codewalk District is a multi-agent workspace that orchestrates multiple AI coding agents (Claude, Codex, etc.) working in parallel on a shared codebase.
|
Codewalkers is a multi-agent workspace that orchestrates multiple AI coding agents (Claude, Codex, etc.) working in parallel on a shared codebase.
|
||||||
|
|
||||||
## System Diagram
|
## System Diagram
|
||||||
|
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
# Initiative Dashboard Wireframe
|
# Initiative Dashboard Wireframe
|
||||||
|
|
||||||
The Initiative Dashboard is the primary entry point for Codewalk District. It displays all initiatives with their status, progress, and quick actions.
|
The Initiative Dashboard is the primary entry point for Codewalkers. It displays all initiatives with their status, progress, and quick actions.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
@@ -274,4 +274,4 @@ When clicking "Spawn Agent" on a pending task:
|
|||||||
|
|
||||||
---
|
---
|
||||||
*Wireframe for: Initiative Detail Screen*
|
*Wireframe for: Initiative Detail Screen*
|
||||||
*Part of: Codewalk District Frontend Design*
|
*Part of: Codewalkers Frontend Design*
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
# Structured Logging
|
# Structured Logging
|
||||||
|
|
||||||
Codewalk District uses [pino](https://getpino.io/) for structured JSON logging on the backend.
|
Codewalkers uses [pino](https://getpino.io/) for structured JSON logging on the backend.
|
||||||
|
|
||||||
## Architecture
|
## Architecture
|
||||||
|
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
# UI Wireframes
|
# UI Wireframes
|
||||||
|
|
||||||
ASCII wireframe mockups documenting the current state of the Codewalk District frontend.
|
ASCII wireframe mockups documenting the current state of the Codewalkers frontend.
|
||||||
|
|
||||||
## Pages
|
## Pages
|
||||||
|
|
||||||
|
|||||||
@@ -27,7 +27,7 @@ Global shell wrapping all pages. Fixed header with navigation, scrollable conten
|
|||||||
|
|
||||||
```
|
```
|
||||||
+============================================================================+
|
+============================================================================+
|
||||||
| [logo] Codewalk District |
|
| [logo] Codewalkers |
|
||||||
| |
|
| |
|
||||||
| [Initiatives] [Agents] [Inbox] [Settings] |
|
| [Initiatives] [Agents] [Inbox] [Settings] |
|
||||||
| ^^^^^^^^^^ |
|
| ^^^^^^^^^^ |
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
# v2 Wireframes
|
# v2 Wireframes
|
||||||
|
|
||||||
Redesigned wireframes for Codewalk District frontend — addressing 13 UX gaps identified in v1.
|
Redesigned wireframes for Codewalkers frontend — addressing 13 UX gaps identified in v1.
|
||||||
|
|
||||||
## Changes from v1
|
## Changes from v1
|
||||||
|
|
||||||
|
|||||||
@@ -206,9 +206,9 @@ into a "+N more" indicator.
|
|||||||
### 3. Browser tab title
|
### 3. Browser tab title
|
||||||
|
|
||||||
When the app is backgrounded and events occur:
|
When the app is backgrounded and events occur:
|
||||||
- `(2) Codewalk District` — number prefix for unread attention items
|
- `(2) Codewalkers` — number prefix for unread attention items
|
||||||
- Counts: crashed agents + pending approvals + unanswered inbox items
|
- Counts: crashed agents + pending approvals + unanswered inbox items
|
||||||
- Resets to `Codewalk District` when user returns to the tab
|
- Resets to `Codewalkers` when user returns to the tab
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -462,7 +462,7 @@ This was the biggest gap. Added three tiers:
|
|||||||
- **Tab badges**: real-time counts (already existed, now specified with attention escalation)
|
- **Tab badges**: real-time counts (already existed, now specified with attention escalation)
|
||||||
- **Toast notifications**: critical events fire toasts regardless of current page.
|
- **Toast notifications**: critical events fire toasts regardless of current page.
|
||||||
Persistent for crashes/approvals, auto-dismiss for informational events.
|
Persistent for crashes/approvals, auto-dismiss for informational events.
|
||||||
- **Browser tab title**: `(2) Codewalk District` prefix when backgrounded with
|
- **Browser tab title**: `(2) Codewalkers` prefix when backgrounded with
|
||||||
unread attention items. Standard web app pattern.
|
unread attention items. Standard web app pattern.
|
||||||
|
|
||||||
The attention escalation on the Agents badge (blue -> red when something crashes)
|
The attention escalation on the Agents badge (blue -> red when something crashes)
|
||||||
|
|||||||
@@ -832,7 +832,7 @@ Add to `<head>` in `index.html` before any stylesheets:
|
|||||||
|
|
||||||
```
|
```
|
||||||
+-------------------------------------------+
|
+-------------------------------------------+
|
||||||
| [logo] Codewalk District [Sun|Monitor|Moon] |
|
| [logo] Codewalkers [Sun|Monitor|Moon] |
|
||||||
+-------------------------------------------+
|
+-------------------------------------------+
|
||||||
|
|
||||||
States:
|
States:
|
||||||
|
|||||||
Reference in New Issue
Block a user