@dyyz1993/create-agent 1.9.0

package/src/commands/workspace.ts

@@ -0,0 +1,129 @@
+import { resolve } from 'path';
+import { execSync } from 'child_process';
+import { existsSync, readFileSync, mkdirSync } from 'fs';
+import { createServer } from 'net';
+import type { PortEntry } from '../lib/types.js';
+
+const PORT_REGISTRY = resolve(process.env.HOME || '~', '.pi-agent', 'ports.json');
+
+function readRegistry(): Record<string, PortEntry> {
+  try {
+    return JSON.parse(readFileSync(PORT_REGISTRY, 'utf-8'));
+  } catch {
+    return {};
+  }
+}
+
+function isPortFree(port: number): Promise<boolean> {
+  return new Promise((resolve) => {
+    const server = createServer();
+    server.once('error', () => resolve(false));
+    server.once('listening', () => { server.close(); resolve(true); });
+    server.listen(port);
+  });
+}
+
+async function findFreePorts(entries: Record<string, PortEntry>): Promise<{ backend: number; vite: number }> {
+  const usedPorts = new Set<number>();
+  for (const entry of Object.values(entries)) {
+    usedPorts.add(entry.port);
+  }
+  let backend = 3100;
+  while (usedPorts.has(backend) || !(await isPortFree(backend))) backend++;
+  let vite = 5173;
+  while (usedPorts.has(vite) || !(await isPortFree(vite))) vite++;
+  return { backend, vite };
+}
+
+export async function runWorkspace(args: string[]): Promise<void> {
+  const subCommand = args[0];
+
+  if (!subCommand || subCommand === '--help' || subCommand === '-h') {
+    console.log(`
+Usage: create-agent workspace add <name> [--base <branch>]
+
+Creates an isolated git worktree in .workspace/<name> with its own branch and ports.
+
+Options:
+  --base <branch>  Base branch for the new worktree (default: current HEAD)
+
+Examples:
+  create-agent workspace add feature-chat-ui
+  create-agent workspace add fix-login --base develop
+`);
+    return;
+  }
+
+  if (subCommand !== 'add') {
+    console.error(`Unknown workspace subcommand: "${subCommand}"`);
+    console.log('Usage: create-agent workspace add <name>');
+    return;
+  }
+
+  let name = '';
+  let baseBranch = '';
+  const rest = args.slice(1);
+  for (let i = 0; i < rest.length; i++) {
+    if (rest[i] === '--base' && rest[i + 1]) {
+      baseBranch = rest[++i];
+    } else if (!rest[i].startsWith('--')) {
+      name = rest[i];
+    }
+  }
+
+  if (!name) {
+    console.error('Error: workspace name is required');
+    process.exit(1);
+  }
+
+  const projectRoot = process.cwd();
+  const workspaceDir = resolve(projectRoot, '.workspace', name);
+
+  if (existsSync(workspaceDir)) {
+    console.error(`Error: workspace "${name}" already exists at ${workspaceDir}`);
+    process.exit(1);
+  }
+
+  const branchName = `workspace/${name}`;
+  const baseArg = baseBranch ? baseBranch : 'HEAD';
+
+  console.log(`Creating workspace: ${name}`);
+  console.log(`  Branch: ${branchName}`);
+  console.log(`  Directory: .workspace/${name}`);
+
+  mkdirSync(resolve(projectRoot, '.workspace'), { recursive: true });
+
+  try {
+    execSync(`git worktree add "${workspaceDir}" -b ${branchName} ${baseArg}`, {
+      cwd: projectRoot,
+      stdio: 'pipe',
+    });
+  } catch (err: unknown) {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(`Failed to create worktree: ${message}`);
+    process.exit(1);
+  }
+
+  const registry = readRegistry();
+  const ports = await findFreePorts(registry);
+
+  console.log(`  Backend port: ${ports.backend}`);
+  console.log(`  Vite port:    ${ports.vite}`);
+  console.log('');
+  console.log('Installing dependencies...');
+  try {
+    execSync('bun install', { cwd: workspaceDir, stdio: 'pipe' });
+  } catch {
+    console.log('(bun install skipped)');
+  }
+
+  console.log('');
+  console.log('Workspace created successfully!');
+  console.log('');
+  console.log('To start developing:');
+  console.log(`  cd .workspace/${name}`);
+  console.log(`  PORT=${ports.backend} VITE_PORT=${ports.vite} bun run dev:web`);
+  console.log('');
+  console.log('Or start from project root:');
+  console.log(`  PORT=${ports.backend} VITE_PORT=${ports.vite} bun run dev:web`);
+}

package/src/lib/copy.ts

@@ -0,0 +1,285 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync, readdirSync } from 'fs';
+import { join, resolve } from 'path';
+import { execSync } from 'child_process';
+
+const SKIP_DIRS = new Set(['node_modules', 'build', 'dist', '.git', '.husky', '.trae']);
+const SKIP_FILES = new Set(['bun.lock', 'rpc-browser.js']);
+
+export interface CopyOptions {
+  projectName: string;
+  templateDir: string;
+  targetDir: string;
+}
+
+export function deriveNames(projectName: string) {
+  const pascalName = projectName.replace(/(^|-)([a-z])/g, (_, _sep, c) => c.toUpperCase());
+  const identifier = `com.${projectName.replace(/-/g, '')}.app`;
+  const shortId = `com.${projectName.replace(/-/g, '')}`;
+  return { pascalName, identifier, shortId };
+}
+
+export function copyAndReplace(srcDir: string, destDir: string, projectName: string): void {
+  const { pascalName, identifier, shortId } = deriveNames(projectName);
+
+  mkdirSync(destDir, { recursive: true });
+
+  const entries = readdirSync(srcDir, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = join(srcDir, entry.name);
+    const destPath = join(destDir, entry.name);
+
+    if (entry.isDirectory()) {
+      if (SKIP_DIRS.has(entry.name)) continue;
+      copyAndReplace(srcPath, destPath, projectName);
+    } else {
+      if (SKIP_FILES.has(entry.name)) continue;
+
+      let content = readFileSync(srcPath, 'utf-8');
+
+      content = content.replace(/pi-agent-template/g, projectName);
+      content = content.replace(/Pi Agent Template/g, pascalName);
+      content = content.replace(/Pi Agent/g, pascalName);
+      content = content.replace(/com\.piagent\.template/g, identifier);
+      content = content.replace(/com\.piagent/g, shortId);
+      content = content.replace(/@pi-agent\//g, `@${projectName}/`);
+
+      writeFileSync(destPath, content);
+    }
+  }
+}
+
+function copyTraeRules(monorepoRoot: string, targetDir: string, projectName: string): void {
+  const traeRulesDir = resolve(monorepoRoot, '.trae', 'rules');
+  if (!existsSync(traeRulesDir)) return;
+
+  const destRulesDir = join(targetDir, '.trae', 'rules');
+  mkdirSync(destRulesDir, { recursive: true });
+
+  const files = readdirSync(traeRulesDir).filter((f) => f !== 'memory.md');
+  for (const file of files) {
+    const src = join(traeRulesDir, file);
+    const dest = join(destRulesDir, file);
+    let content = readFileSync(src, 'utf-8');
+    content = content.replace(/pi-agent-template/g, projectName);
+    writeFileSync(dest, content);
+  }
+}
+
+function copySharedModules(monorepoRoot: string, targetDir: string, projectName: string): void {
+  const sharedDir = resolve(monorepoRoot, 'templates', 'shared');
+  if (!existsSync(sharedDir)) return;
+
+  const destSharedDir = join(targetDir, 'shared');
+  copyAndReplace(sharedDir, destSharedDir, projectName);
+
+  const tsconfigPath = join(targetDir, 'tsconfig.json');
+  if (existsSync(tsconfigPath)) {
+    let tsconfig = readFileSync(tsconfigPath, 'utf-8');
+    tsconfig = tsconfig.replace(/"\.\.\/shared\/\*"/g, '"./shared/*"');
+    tsconfig = tsconfig.replace(/"\.\.\/shared"/g, '"./shared"');
+    writeFileSync(tsconfigPath, tsconfig);
+  }
+
+  cleanSharedViteConfig(destSharedDir);
+}
+
+function cleanViteConfig(targetDir: string): void {
+  const viteConfigPath = join(targetDir, "vite.config.ts");
+  const vitestConfigPath = join(targetDir, "vitest.config.ts");
+
+  for (const configPath of [viteConfigPath, vitestConfigPath]) {
+    if (!existsSync(configPath)) continue;
+
+    let config = readFileSync(configPath, "utf-8");
+    
+    config = config.replace(
+      /,\n\s+resolve:\s*\{\n\s+alias:\s*\{[^}]*\}[,\s]*\}[,;]?\n/g,
+      ""
+    );
+    
+    if (!config.includes('from "path"') && config.includes("resolve(")) {
+      config = 'import { resolve } from "path";\n' + config;
+    }
+    
+    config = config.replace(/from ["']\.\.\/shared\/vite-base\.config["']/g, 'from "./shared/vite-base.config"');
+    config = config.replace(/from ["']\.\.\/shared\/vitest-base\.config["']/g, 'from "./shared/vitest-base.config"');
+    
+    writeFileSync(configPath, config);
+  }
+}
+
+function cleanSharedViteConfig(sharedDir: string): void {
+  const viteBaseConfigPath = join(sharedDir, "vite-base.config.ts");
+  const vitestBaseConfigPath = join(sharedDir, "vitest-base.config.ts");
+
+  for (const configPath of [viteBaseConfigPath, vitestBaseConfigPath]) {
+    if (!existsSync(configPath)) continue;
+
+    let config = readFileSync(configPath, "utf-8");
+    config = config.replace(
+      /,\n\s+resolve:\s*\{\n\s+alias:\s*\{[^}]*\}[,\s]*\}[,;]?\n/g,
+      ""
+    );
+    config = config.replace(
+      /,\n\s+alias:\s*\{[^}]*\}[,\s]*[,;]?\n/g,
+      ""
+    );
+    if (!config.includes("resolve(")) {
+      config = config.replace(/import\s*\{\s*resolve\s*\}\s*from\s*["']path["'];?\n?/g, "");
+      config = config.replace(
+        /export function create(Vite|Vitest)Config\(dirname: string\)/g,
+        "export function create$1Config()"
+      );
+    }
+    writeFileSync(configPath, config);
+  }
+}
+
+function resolvePackageVersion(packageName: string): string {
+  try {
+    return execSync(`npm view ${packageName} version`, { encoding: 'utf-8' }).trim();
+  } catch {
+    return '1.0.0';
+  }
+}
+
+const WORKSPACE_PACKAGES = [
+  '@dyyz1993/rpc-core',
+  '@dyyz1993/eslint-plugin-rpc',
+];
+
+function updatePackageJson(targetDir: string, _projectName: string): void {
+  const rootPkgPath = join(targetDir, 'package.json');
+  if (!existsSync(rootPkgPath)) return;
+
+  const rootPkg = JSON.parse(readFileSync(rootPkgPath, 'utf-8'));
+
+  delete rootPkg.workspaces;
+
+  for (const depKey of ['dependencies', 'devDependencies'] as const) {
+    if (!rootPkg[depKey]) continue;
+    for (const pkgName of WORKSPACE_PACKAGES) {
+      if (!rootPkg[depKey][pkgName]) continue;
+      if (pkgName === '@dyyz1993/rpc-core') {
+        const version = resolvePackageVersion(pkgName);
+        rootPkg[depKey][pkgName] = `^${version}`;
+      } else {
+        delete rootPkg[depKey][pkgName];
+      }
+    }
+  }
+
+  writeFileSync(rootPkgPath, JSON.stringify(rootPkg, null, '\t') + '\n');
+
+  const eslintConfigPath = join(targetDir, 'eslint.config.mjs');
+  if (existsSync(eslintConfigPath)) {
+    const lines = readFileSync(eslintConfigPath, 'utf-8').split('\n');
+    const filteredLines: string[] = [];
+
+    let inRpcSection = false;
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+      
+      if (line.includes('import rpcPlugin') && line.includes('@dyyz1993/eslint-plugin-rpc')) {
+        continue;
+      }
+      
+      if (line.includes('RPC') && line.includes('规范规则')) {
+        inRpcSection = true;
+        continue;
+      }
+      
+      if (inRpcSection) {
+        if (line.trim().startsWith("'rpc/") || line.trim().startsWith('"rpc/')) {
+          continue;
+        }
+        inRpcSection = false;
+      }
+      
+      if (line.includes('rpc: rpcPlugin')) {
+        continue;
+      }
+      
+      filteredLines.push(line);
+    }
+
+    let content = filteredLines.join('\n');
+    content = content.replace(/\n\s+plugins:\s*\{\s*\},?\s*\n/g, '\n');
+
+    writeFileSync(eslintConfigPath, content);
+  }
+}
+
+export async function copyTemplate(options: CopyOptions): Promise<void> {
+  const { projectName, templateDir, targetDir } = options;
+  const localRoot = resolve(import.meta.dir, '..', '..', '..', '..');
+  const isMonorepo = existsSync(resolve(localRoot, 'templates', 'general'));
+
+  if (existsSync(targetDir)) {
+    throw new Error(`Directory "${targetDir}" already exists.`);
+  }
+
+  const { identifier } = deriveNames(projectName);
+
+  console.log(`Creating project: ${projectName}`);
+  console.log(`Target directory: ${targetDir}`);
+  console.log(`App identifier:   ${identifier}`);
+  console.log('');
+
+  copyAndReplace(templateDir, targetDir, projectName);
+  if (isMonorepo) {
+    copyTraeRules(localRoot, targetDir, projectName);
+    copySharedModules(localRoot, targetDir, projectName);
+  }
+  cleanViteConfig(targetDir);
+  updatePackageJson(targetDir, projectName);
+
+  console.log('Initializing git...');
+  execSync('git init', { cwd: targetDir, stdio: 'pipe' });
+
+  console.log('Installing dependencies...');
+  execSync('bun install', { cwd: targetDir, stdio: 'inherit' });
+
+  console.log('Building browser bundle...');
+  try {
+    execSync('bun run build:browser', { cwd: targetDir, stdio: 'pipe' });
+  } catch {
+    console.log('(build:browser skipped - script not found)');
+  }
+
+  const huskyDir = join(targetDir, '.husky');
+  mkdirSync(huskyDir, { recursive: true });
+  writeFileSync(
+    join(huskyDir, 'pre-commit'),
+    [
+      '#!/bin/sh',
+      'bun run lint',
+      'ERRORS=$(bunx tsc --noEmit 2>&1 | grep "error TS" | grep -v "node_modules" || true)',
+      'if [ -n "$ERRORS" ]; then',
+      '  echo "$ERRORS"',
+      '  exit 1',
+      'fi',
+    ].join('\n') + '\n',
+  );
+
+  execSync('git add -A', { cwd: targetDir, stdio: 'pipe' });
+
+  try {
+    execSync(`git commit --no-verify -m "feat: init ${projectName} from pi-agent-template"`, {
+      cwd: targetDir,
+      stdio: 'pipe',
+    });
+  } catch {
+    console.log('(git commit skipped - no files to commit)');
+  }
+
+  console.log('');
+  console.log('Project created successfully!');
+  console.log('');
+  console.log('Next steps:');
+  console.log(`  cd ${targetDir}`);
+  console.log('  bun run dev          # Start desktop app (Electrobun)');
+  console.log('  bun run dev:web      # Start web mode (Vite + Gateway)');
+  console.log('');
+}

package/src/lib/templates.ts

@@ -0,0 +1,57 @@
+import { resolve } from 'path';
+import { existsSync } from 'fs';
+
+interface TemplateInfo {
+  type: string;
+  description: string;
+  available: boolean;
+  dir: string;
+}
+
+const TEMPLATES: TemplateInfo[] = [
+  {
+    type: 'general',
+    description: 'Full-featured template (File explorer, Git, Search, Chat, Timer, Feed)',
+    available: true,
+    dir: 'templates/general',
+  },
+  {
+    type: 'chat',
+    description: 'Chat-focused template (Enhanced ChatPanel, Markdown, Session management)',
+    available: true,
+    dir: 'templates/chat',
+  },
+  {
+    type: 'agent',
+    description: 'Coding agent template (Bash, Rules engine, Todo management)',
+    available: true,
+    dir: 'templates/agent',
+  },
+];
+
+export function getTemplateInfo(type: string): TemplateInfo | undefined {
+  return TEMPLATES.find((t) => t.type === type);
+}
+
+export function getAllTemplates(): TemplateInfo[] {
+  return TEMPLATES;
+}
+
+export function resolveTemplateDir(monorepoRoot: string, type: string): string {
+  const info = getTemplateInfo(type);
+  if (!info) {
+    throw new Error(`Unknown template type: "${type}". Run "create-agent list" to see available types.`);
+  }
+  if (!info.available) {
+    throw new Error(`Template "${type}" is not available yet (coming soon).`);
+  }
+  return resolve(monorepoRoot, info.dir);
+}
+
+export function getRootDir(): string {
+  const localRoot = resolve(import.meta.dir, '..', '..', '..', '..');
+  if (existsSync(resolve(localRoot, 'templates', 'general'))) {
+    return localRoot;
+  }
+  return resolve(import.meta.dir, '..', '..');
+}

package/src/lib/types.ts

@@ -0,0 +1,6 @@
+export interface PortEntry {
+  name: string;
+  port: number;
+  pid: number;
+  startedAt: string;
+}

package/templates/agent/.env.example

@@ -0,0 +1,7 @@
+# Web server configuration
+PORT=3100
+AUTH_TOKEN=your-secret-token-here
+MAX_UPLOAD_SIZE=5242880
+LOG_DIR=logs
+ENABLE_BASH=true
+CORS_ORIGIN=http://localhost:5173

package/templates/agent/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 [username]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/templates/agent/README.md

@@ -0,0 +1,87 @@
+# Pi Agent Template
+
+Coding agent template built with Electrobun, React, Tailwind CSS, and RPC architecture. Extends the general template with **Bash**, **Rules**, and **Todo** management.
+
+## Getting Started
+
+```bash
+bun install
+
+# Development with HMR (recommended)
+bun run dev:web
+
+# Development without HMR
+bun run dev
+
+# Build
+bun run build
+```
+
+## Features
+
+All features from the **general** template, plus:
+
+- **Bash Panel** — Execute shell commands, manage multiple processes, view output in a terminal-like interface
+- **Rules Engine** — Define glob-pattern rules with enable/disable toggles for customizing agent behavior
+- **Todo Manager** — Track tasks with pending/in_progress/completed status cycling
+
+## RPC Modules
+
+| Module | Methods | Events | Description |
+|---|---|---|---|
+| `system` | ping, hello, echo | - | Connectivity test |
+| `file` | listDir, readFile, createFile, createDir, rename, delete, copy, findProjectRoot | - | File system operations |
+| `timer` | start, stop | timer.tick | Timer + real-time push |
+| `chat` | list, send | chat.message | Chat (supports role filtering) |
+| `git` | status, diff, log, branches, checkout, add, reset, commit, push, pull | - | Git version control |
+| `feed` | post, list | feed.update | Feed stream (supports category filtering) |
+| `bash` | execute, kill, listProcesses | bash.output, bash.exit | Shell command execution |
+| `rules` | list, add, toggle, remove | - | Rule management |
+| `todo` | list, add, update, remove | - | Task tracking |
+
+## Project Structure
+
+```
+├── src/
+│   ├── bun/
+│   │   └── index.ts          # Desktop entry (Electrobun main process)
+│   ├── server.ts             # Web entry (HTTP + WebSocket server)
+│   ├── gateway/
+│   │   ├── http-routes.ts    # HTTP endpoints
+│   │   ├── ws-handler.ts     # WebSocket RPC server
+│   │   └── ipc-transport.ts  # Electrobun IPC bridge
+│   ├── shared/
+│   │   ├── rpc-schema.ts     # Unified RPC type definitions
+│   │   ├── register-all-handlers.ts
+│   │   ├── modules/          # RPC method type definitions
+│   │   │   ├── bash.ts       # Bash RPC types
+│   │   │   ├── rules.ts      # Rules RPC types
+│   │   │   └── todo.ts       # Todo RPC types
+│   │   └── handlers/         # RPC handler implementations
+│   │       ├── bash.ts       # Bash handler (Bun.spawn)
+│   │       ├── rules.ts      # Rules CRUD handler
+│   │       └── todo.ts       # Todo CRUD handler
+│   └── mainview/             # React frontend
+│       ├── App.tsx           # Main app with Bash/Rules/Todo tabs
+│       ├── components/
+│       │   ├── activity-bar/ # Sidebar + mobile tabs (includes Rules)
+│       │   ├── bash/         # BashPanel — terminal interface
+│       │   ├── rules/        # RulesPanel — rule management
+│       │   ├── todo/         # TodoPanel — task management
+│       │   ├── chat/
+│       │   ├── explorer/
+│       │   ├── feed/
+│       │   ├── git/
+│       │   ├── search/
+│       │   └── debug/
+│       ├── stores/
+│       │   ├── use-bash-store.ts   # Bash process state
+│       │   ├── use-rules-store.ts  # Rules state
+│       │   └── use-todo-store.ts   # Todo state
+│       └── lib/
+│           └── api-client.ts       # Typed RPC client
+├── eslint-plugin-rpc/
+├── electrobun.config.ts
+├── vite.config.ts
+└── tailwind.config.js
+```