# DevPilot

**Repository Path**: shinchancn/dev-pilot

## Basic Information

- **Project Name**: DevPilot
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-13
- **Last Updated**: 2026-06-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DevPilot

DevPilot is a local AI development process orchestration platform.

It coordinates project workflows such as development, review, rectification, UAT, Browser verification, evidence tracking, and acceptance across multiple workspaces.

## Phase 1 Scope

1. Use `process-conpty` as the first executable Runtime.
2. Use `codex-desktop` as the first enabled Agent Adapter.
3. Keep DeepSeek API as an analysis-only adapter placeholder.
4. Keep OpenCode and Claude Code as future Agent Adapter placeholders.
5. Use Script Workers for deterministic checks and dashboard state generation.
6. Do not promise pause/resume. Phase 1 supports stop-after-current-stage and timeout cancellation.

## Key Directories

```text
config/                 Workspace and project configuration
schemas/                Stage input and result JSON schemas
templates/              Flow, prompt, and checklist templates
runtime/runtimes/       Runtime implementations such as process-conpty
runtime/agents/         Agent Adapter implementations or placeholders
runtime/script-workers/ Deterministic Script Worker implementations
runs/                   Runtime run records
commands/               Control commands
locks/                  Runtime locks
server/                 Local API server contract and future implementation
ui/                     Future management UI
docs/                   Planning, POC, and API baseline documents
```

## Scheduler

Run one scheduling tick:

```powershell
npm run tick
```

Run the local scheduler loop:

```powershell
npm run scheduler
```

The loop interval defaults to 10 seconds and can be changed with:

```powershell
$env:DEVPILOT_TICK_SECONDS = "5"
npm run scheduler
```

The scheduler consumes command files from `commands/`, reconciles completed `runs/*/result.json`, starts ready tasks when the queue is running, and writes the current dashboard snapshot to `state/dashboard.json`.