Task attempt 02d563d2-c280-47fd-8ea8-e1ab401cba5b - Final changes

npx-cli/README.md

@@ -60,51 +60,40 @@ Vibe Kanban is a modern project management tool designed specifically for develo
 4. **Review Changes**: See exactly what was modified using git diffs
 5. **Merge Results**: Incorporate successful changes into your main codebase
 
-## API Endpoints
+## Core Functionality
 
-Vibe Kanban provides a comprehensive REST API:
+Vibe Kanban provides a complete project management experience with these key capabilities:
 
-### Projects (`/api/projects`)
+**Project Repository Management**
-- `GET /projects` - List all projects
+- Full CRUD operations for managing coding projects
-- `POST /projects` - Create new project
+- Automatic git repository detection and validation  
-- `GET /projects/:id` - Get project details
+- Initialize new repositories or import existing ones
-- `PUT /projects/:id` - Update project
+- Project-wide file search functionality
-- `DELETE /projects/:id` - Delete project
-- `GET /projects/:id/search` - Search files in project
 
-### Tasks (`/api/projects/:project_id/tasks`)
+**Task Lifecycle Management**
-- `GET /tasks` - List project tasks
+- Create, update, and delete tasks with rich descriptions
-- `POST /tasks` - Create new task
+- Track task progress through customizable status workflows
-- `POST /tasks/create-and-start` - Create task and start execution
+- One-click task creation with immediate AI agent execution
-- `GET /tasks/:task_id` - Get task details
+- Task attempt tracking with detailed execution history
-- `PUT /tasks/:task_id` - Update task
-- `DELETE /tasks/:task_id` - Delete task
 
-### Task Attempts (`/api/projects/:project_id/tasks/:task_id/attempts`)
+**AI Agent Execution Environment**
-- `GET /attempts` - List task attempts
+- Isolated git worktrees for safe code experimentation
-- `POST /attempts` - Create new attempt
+- Real-time execution monitoring and activity logging
-- `GET /attempts/:attempt_id/activities` - Get execution activities
+- Process management with ability to stop individual or all processes
-- `GET /attempts/:attempt_id/diff` - View changes made
+- Support for follow-up executions to iterate on solutions
-- `POST /attempts/:attempt_id/merge` - Merge changes to main
-- `POST /attempts/:attempt_id/rebase` - Rebase onto main branch
-- `GET /attempts/:attempt_id/branch-status` - Check branch status
-- `POST /attempts/:attempt_id/open-editor` - Open in code editor
-- `POST /attempts/:attempt_id/follow-up` - Continue with follow-up execution
-- `POST /attempts/:attempt_id/start-dev-server` - Start development server
-- `POST /attempts/:attempt_id/stop` - Stop all execution processes
 
-### Configuration (`/api/config`)
+**Code Change Management**
-- `GET /config` - Get current configuration
+- View detailed diffs of all changes made during task execution
-- `POST /config` - Update configuration
+- Branch status monitoring to track divergence from main
-- `GET /config/constants` - Get available options
+- One-click merging of successful changes back to main branch
+- Automatic rebasing to keep task branches up-to-date
+- Manual file deletion and cleanup capabilities
 
-### Filesystem (`/api/filesystem`)
+**Development Integration**
-- `GET /filesystem/list` - Browse directories
+- Open task worktrees directly in your preferred code editor
-- `GET /filesystem/validate-git` - Validate git repository
+- Start and manage development servers for testing changes
-- `GET /filesystem/create-git` - Initialize new git repository
+- Browse local filesystem to add new projects
-
+- Health monitoring for service availability
-### Health (`/api/health`)
-- `GET /health` - Service health check
 
 ## Configuration