feat: init, validate and copy functionality

Author: captjt

README.md

@@ -249,6 +249,8 @@ groups:
 | `Ctrl+u/d`      | Half page up / down          |
 | `e`             | Export current service logs  |
 | `E` (shift)     | Export all logs              |
+| `y`             | Copy last log to clipboard   |
+| `Y` (shift)     | Copy all visible logs        |
 
 ### Search
 
@@ -282,6 +284,8 @@ Commands:
   down          Stop all services
   restart       Restart all services
   status        Show service status
+  init          Create a new devproc.yaml config file
+  validate      Validate the config file without starting services
 
 Options:
   -c, --config  Path to config file (default: devproc.yaml)
@@ -290,6 +294,22 @@ Options:
   -v, --version Show version
 ```
 
+### Quick Start with `init`
+
+```bash
+# Create a new config file in the current directory
+devproc init
+
+# Validate your config before running
+devproc validate
+```
+
+The `init` command will:
+
+- Detect your project name from `package.json` if present
+- Suggest services based on npm scripts (dev, start, etc.)
+- Create a commented template with examples
+
 ### Config Reload
 
 DevProc supports hot-reloading your configuration without restarting:

docs/ROADMAP.md

@@ -215,8 +215,8 @@ Optional web UI for remote access.
 ### Configuration
 
 - [ ] JSON schema for IDE autocomplete
-- [ ] Config validation command: `devproc validate`
-- [ ] Init command: `devproc init` to generate starter config
+- [x] Config validation command: `devproc validate`
+- [x] Init command: `devproc init` to generate starter config
 - [ ] Import from docker-compose.yml
 - [ ] Import from Procfile
 
@@ -228,7 +228,7 @@ Optional web UI for remote access.
 - [ ] Resize panes with keyboard
 - [ ] Multiple log panes (split view)
 - [ ] Bookmark log lines
-- [ ] Copy log lines to clipboard
+- [x] Copy log lines to clipboard (`y` / `Y`)
 
 ### Performance
 
@@ -288,6 +288,9 @@ Want to help build these features? Here's how:
 - Real-time CPU % and memory usage displayed in service list
 - Resource graph view with sparkline visualization (toggle with `m`)
 - Color-coded CPU usage indicators
+- Added `devproc init` command to scaffold starter config
+- Added `devproc validate` command to check config for errors
+- Added clipboard support (`y` to copy last log, `Y` to copy all visible logs)
 
 ### v0.4.0
 

src/app.tsx

@@ -6,6 +6,7 @@ import type { ProcessManager } from "./process/manager"
 import { useServices, type DisplayItem } from "./ui/hooks/useServices"
 import { useLogs, type SearchMatch } from "./ui/hooks/useLogs"
 import { formatBytes, formatCpu, generateSparkline } from "./process/resources"
+import { copyToClipboard } from "./utils/clipboard"
 
 interface AppProps {
   manager: ProcessManager
@@ -275,6 +276,54 @@ export function App(props: AppProps) {
     }
   }
 
+  // Copy last log line to clipboard
+  const handleCopyLog = async () => {
+    const logs = visibleLogs()
+    if (logs.length === 0) {
+      setStatusMessage("No logs to copy")
+      setTimeout(() => setStatusMessage(null), 2000)
+      return
+    }
+
+    // Get the last log line
+    const lastLog = logs[logs.length - 1]!
+    const time = formatLogTime(lastLog.timestamp)
+    const logLine = `[${time}] ${lastLog.service} | ${lastLog.content}`
+
+    const success = await copyToClipboard(logLine)
+    if (success) {
+      setStatusMessage("Copied to clipboard")
+    } else {
+      setStatusMessage("Copy failed")
+    }
+    setTimeout(() => setStatusMessage(null), 2000)
+  }
+
+  // Copy all visible logs to clipboard
+  const handleCopyAllLogs = async () => {
+    const logs = visibleLogs()
+    if (logs.length === 0) {
+      setStatusMessage("No logs to copy")
+      setTimeout(() => setStatusMessage(null), 2000)
+      return
+    }
+
+    const content = logs
+      .map((log) => {
+        const time = formatLogTime(log.timestamp)
+        return `[${time}] ${log.service} | ${log.content}`
+      })
+      .join("\n")
+
+    const success = await copyToClipboard(content)
+    if (success) {
+      setStatusMessage(`Copied ${logs.length} lines`)
+    } else {
+      setStatusMessage("Copy failed")
+    }
+    setTimeout(() => setStatusMessage(null), 2000)
+  }
+
   // Keyboard handling
   useKeyboard((event: { name: string; ctrl: boolean; shift: boolean; preventDefault: () => void }) => {
     // Handle search mode input
@@ -576,6 +625,18 @@ export function App(props: AppProps) {
         setShowResourceGraph((prev) => !prev)
         event.preventDefault()
         break
+
+      // Copy to clipboard
+      case "y":
+        if (event.shift) {
+          // Y - copy all visible logs
+          handleCopyAllLogs()
+        } else {
+          // y - copy last log line
+          handleCopyLog()
+        }
+        event.preventDefault()
+        break
     }
   })
 
@@ -910,6 +971,9 @@ export function App(props: AppProps) {
           <text>/ Start search | n Next match | N Prev match</text>
           <text>Esc Clear search</text>
           <text> </text>
+          <text fg="yellow">Clipboard</text>
+          <text>y Copy last log | Y Copy all visible logs</text>
+          <text> </text>
           <text fg="yellow">Config</text>
           <text>Ctrl+L Reload config from disk</text>
           <text> </text>

src/index.tsx

@@ -1,7 +1,7 @@
 #!/usr/bin/env bun
 import { render } from "@opentui/solid"
 import { watch } from "fs"
-import { loadConfig } from "./config/loader"
+import { loadConfig, findConfigFile } from "./config/loader"
 import { ProcessManager } from "./process/manager"
 import { App } from "./app"
 
@@ -19,6 +19,8 @@ Commands:
   down          Stop all services
   restart       Restart all services
   status        Show service status (non-interactive)
+  init          Create a new devproc.yaml config file
+  validate      Validate the config file without starting services
 
 Options:
   -c, --config <file>   Path to config file (default: devproc.yaml)
@@ -29,11 +31,189 @@ Options:
 Examples:
   devproc               Start all services with TUI
   devproc up            Start all services with TUI
+  devproc init          Create a starter config file
+  devproc validate      Check config for errors
   devproc -c dev.yaml   Use custom config file
   devproc -w            Auto-reload on config changes
 `)
 }
 
+/**
+ * Generate a starter devproc.yaml config file
+ */
+async function initConfig(): Promise<void> {
+  const configPath = "devproc.yaml"
+  const file = Bun.file(configPath)
+
+  if (await file.exists()) {
+    console.error(`Error: ${configPath} already exists`)
+    console.log("Use a different directory or remove the existing file.")
+    process.exit(1)
+  }
+
+  // Try to detect project type from package.json
+  let projectName = "my-project"
+  let suggestedServices = ""
+
+  const pkgFile = Bun.file("package.json")
+  if (await pkgFile.exists()) {
+    try {
+      const pkg = await pkgFile.json()
+      projectName = pkg.name || projectName
+
+      // Suggest services based on scripts
+      const scripts = pkg.scripts || {}
+      const suggestions: string[] = []
+
+      if (scripts.dev) {
+        suggestions.push(`  # Frontend dev server
+  web:
+    cmd: ${pkg.packageManager?.startsWith("bun") ? "bun" : "npm"} run dev
+    color: cyan`)
+      }
+
+      if (scripts.start) {
+        suggestions.push(`  # Main application
+  app:
+    cmd: ${pkg.packageManager?.startsWith("bun") ? "bun" : "npm"} run start
+    color: green`)
+      }
+
+      if (scripts["start:dev"] || scripts["dev:server"]) {
+        const script = scripts["start:dev"] ? "start:dev" : "dev:server"
+        suggestions.push(`  # Dev server
+  server:
+    cmd: ${pkg.packageManager?.startsWith("bun") ? "bun" : "npm"} run ${script}
+    color: green`)
+      }
+
+      if (suggestions.length > 0) {
+        suggestedServices = suggestions.join("\n\n")
+      }
+    } catch {
+      // Ignore JSON parse errors
+    }
+  }
+
+  // Default services if we couldn't detect any
+  if (!suggestedServices) {
+    suggestedServices = `  # Example: Web server
+  # web:
+  #   cmd: npm run dev
+  #   color: cyan
+
+  # Example: API server
+  # api:
+  #   cmd: go run ./cmd/api
+  #   healthcheck:
+  #     cmd: curl -f http://localhost:8080/health
+  #     interval: 2s
+  #     retries: 30
+  #   color: green
+
+  # Example: Worker process
+  # worker:
+  #   cmd: npm run worker
+  #   depends_on:
+  #     - api
+  #   restart: on-failure
+
+  # Example: Docker database
+  # postgres:
+  #   cmd: docker run --rm -p 5432:5432 -e POSTGRES_PASSWORD=dev postgres:16
+  #   healthcheck: pg_isready -h localhost -p 5432
+
+  # Placeholder service (remove this)
+  echo:
+    cmd: "bash -c 'while true; do echo Hello from devproc; sleep 5; done'"
+    color: cyan`
+  }
+
+  const configContent = `# DevProc Configuration
+# Documentation: https://github.com/captjt/devproc
+
+name: ${projectName}
+
+# Global environment variables (applied to all services)
+# env:
+#   NODE_ENV: development
+
+# Load environment from .env file
+# dotenv: .env
+
+# Organize services into groups (optional)
+# groups:
+#   backend:
+#     - api
+#     - worker
+#   frontend:
+#     - web
+
+services:
+${suggestedServices}
+`
+
+  await Bun.write(configPath, configContent)
+  console.log(`Created ${configPath}`)
+  console.log("")
+  console.log("Next steps:")
+  console.log("  1. Edit devproc.yaml to configure your services")
+  console.log("  2. Run 'devproc' to start all services")
+  console.log("  3. Press '?' for keyboard shortcuts")
+}
+
+/**
+ * Validate the config file and report any errors
+ */
+async function validateConfig(configPath?: string): Promise<void> {
+  console.log("Validating configuration...")
+  console.log("")
+
+  try {
+    const config = await loadConfig(configPath)
+
+    console.log(`✓ Config file: ${config.configPath}`)
+    console.log(`✓ Project name: ${config.name}`)
+    console.log(`✓ Services: ${config.services.size}`)
+
+    // List services with their dependencies
+    console.log("")
+    console.log("Services:")
+    for (const [name, service] of config.services) {
+      const deps = Array.from(service.dependsOn.keys())
+      const depStr = deps.length > 0 ? ` (depends on: ${deps.join(", ")})` : ""
+      const healthStr = service.healthcheck ? " [healthcheck]" : ""
+      const groupStr = service.group ? ` [group: ${service.group}]` : ""
+      console.log(`  • ${name}${depStr}${healthStr}${groupStr}`)
+    }
+
+    // List groups
+    if (config.groups.size > 0) {
+      console.log("")
+      console.log("Groups:")
+      for (const [name, group] of config.groups) {
+        console.log(`  • ${name}: ${group.services.join(", ")}`)
+      }
+    }
+
+    console.log("")
+    console.log("✓ Configuration is valid!")
+  } catch (error) {
+    console.error("✗ Configuration error:")
+    console.error("")
+    if (error instanceof Error) {
+      // Format the error message nicely
+      const lines = error.message.split("\n")
+      for (const line of lines) {
+        console.error(`  ${line}`)
+      }
+    } else {
+      console.error(`  ${error}`)
+    }
+    process.exit(1)
+  }
+}
+
 async function main() {
   const args = process.argv.slice(2)
   let configPath: string | undefined
@@ -65,7 +245,7 @@ async function main() {
     }
 
     // Commands
-    if (["up", "down", "restart", "status"].includes(arg!)) {
+    if (["up", "down", "restart", "status", "init", "validate"].includes(arg!)) {
       command = arg!
       continue
     }
@@ -75,6 +255,18 @@ async function main() {
     process.exit(1)
   }
 
+  // Handle init command (doesn't need existing config)
+  if (command === "init") {
+    await initConfig()
+    process.exit(0)
+  }
+
+  // Handle validate command
+  if (command === "validate") {
+    await validateConfig(configPath)
+    process.exit(0)
+  }
+
   try {
     // Load configuration
     const config = await loadConfig(configPath)