project-orchestrator

Category: Tools & Productivity | Uploader: this-rs | Downloads: 0 | Version: v1.0（Latest）

AI agent orchestrator with Neo4j knowledge graph, Meilisearch search, and Tree-sitter parsing. Use for coordinating multiple coding agents on complex projects with shared context and plans.

Changelog: Source: GitHub https://github.com/this-rs/project-orchestrator

Directory Structure

Current level: Root

📁 .cargo/
- 📄 config.toml 58 B
📁 .github/
- 📁 workflows/
  - 📄 ci.yml 8.9 KB
  - 📄 release.yml 68.5 KB
📁 crates/
- 📁 tree-sitter-hcl/
  - 📁 src/
    
    📁 tree_sitter/
    
    📄 parser.h 5.3 KB
    
    📄 lib.rs 874 B
    
    📄 node-types.json 21.2 KB
    
    📄 parser.c 932.3 KB
    
    📄 scanner.c 127 B
    
    📄 scanner.cc 9.5 KB
  - 📄 build.rs 822 B
  - 📄 Cargo.toml 380 B
📁 desktop/
- 📁 src-tauri/
  - 📁 capabilities/
    
    📄 default.json 894 B
    
    📄 remote.json 1.2 KB
  - 📁 icons/
    
    📁 android/
    
    📁 mipmap-anydpi-v26/
    
    📄 ic_launcher.xml 261 B
    
    📁 mipmap-hdpi/
    
    📄 ic_launcher.png 3.1 KB
    
    📄 ic_launcher_foreground.png 11.6 KB
    
    📄 ic_launcher_round.png 2.8 KB
    
    📁 mipmap-mdpi/
    
    📄 ic_launcher.png 2.8 KB
    
    📄 ic_launcher_foreground.png 7.3 KB
    
    📄 ic_launcher_round.png 2.6 KB
    
    📁 mipmap-xhdpi/
    
    📄 ic_launcher.png 7.2 KB
    
    📄 ic_launcher_foreground.png 15.7 KB
    
    📄 ic_launcher_round.png 6.0 KB
    
    📁 mipmap-xxhdpi/
    
    📄 ic_launcher.png 11.8 KB
    
    📄 ic_launcher_foreground.png 24.6 KB
    
    📄 ic_launcher_round.png 9.1 KB
    
    📁 mipmap-xxxhdpi/
    
    📄 ic_launcher.png 16.8 KB
    
    📄 ic_launcher_foreground.png 34.3 KB
    
    📄 ic_launcher_round.png 12.0 KB
    
    📁 values/
    
    📄 ic_launcher_background.xml 115 B
    
    📁 ios/
    
    📄 [email protected] 821 B
    
    📄 [email protected] 1.8 KB
    
    📄 [email protected] 1.8 KB
    
    📄 [email protected] 3.1 KB
    
    📄 [email protected] 1.3 KB
    
    📄 [email protected] 3.1 KB
    
    📄 [email protected] 3.1 KB
    
    📄 [email protected] 4.7 KB
    
    📄 [email protected] 1.8 KB
    
    📄 [email protected] 4.3 KB
    
    📄 [email protected] 4.3 KB
    
    📄 [email protected] 6.7 KB
    
    📄 [email protected] 69.4 KB
    
    📄 [email protected] 6.7 KB
    
    📄 [email protected] 10.5 KB
    
    📄 [email protected] 4.1 KB
    
    📄 [email protected] 8.6 KB
    
    📄 [email protected] 9.8 KB
    
    📄 128x128.png 8.9 KB
    
    📄 [email protected] 19.7 KB
    
    📄 32x32.png 1.8 KB
    
    📄 64x64.png 4.0 KB
    
    📄 icon-source.png 173.2 KB
    
    📄 icon.icns 229.2 KB
    
    📄 icon.ico 30.8 KB
    
    📄 icon.png 44.6 KB
    
    📄 Square107x107Logo.png 7.3 KB
    
    📄 Square142x142Logo.png 9.9 KB
    
    📄 Square150x150Logo.png 10.5 KB
    
    📄 Square284x284Logo.png 21.2 KB
    
    📄 Square30x30Logo.png 1.6 KB
    
    📄 Square310x310Logo.png 23.7 KB
    
    📄 Square44x44Logo.png 2.6 KB
    
    📄 Square71x71Logo.png 4.5 KB
    
    📄 Square89x89Logo.png 6.0 KB
    
    📄 StoreLogo.png 3.1 KB
  - 📁 nsis/
    
    📄 hooks.nsh 2.3 KB
  - 📁 src/
    
    📁 plugins/
    
    📄 mac_rounded_corners.rs 7.2 KB
    
    📄 mod.rs 29 B
    
    📄 docker.rs 27.3 KB
    
    📄 main.rs 29.2 KB
    
    📄 setup.rs 67.0 KB
    
    📄 tray.rs 7.5 KB
    
    📄 updater.rs 7.6 KB
  - 📄 build.rs 3.0 KB
  - 📄 Cargo.lock 229.8 KB
  - 📄 Cargo.toml 1.5 KB
  - 📄 entitlements.plist 451 B
  - 📄 splash.html 30.0 KB
  - 📄 tauri.conf.json 2.9 KB
📁 dist/
- 📁 assets/
  - 📄 core-DhEqZVGG.js 2.4 KB
  - 📄 event-DjZVAIBO.js 1.3 KB
  - 📄 index-BUoHRphY.css 130.9 KB
  - 📄 index-Dhzfp3-x.js 1.3 MB
  - 📄 index-Z9hZp5N5.js 5.7 KB
  - 📄 window-DgZLKhRJ.js 13.7 KB
- 📄 .gitkeep 0 B
- 📄 favicon.ico 14.7 KB
- 📄 index.html 804 B
- 📄 logo-192.png 2.0 KB
- 📄 logo-32.png 1.4 KB
- 📄 logo-512.png 58.5 KB
- 📄 vite.svg 1.4 KB
📁 docs/
- 📁 api/
  - 📄 mcp-tools.md 24.7 KB
  - 📄 reference.md 50.3 KB
- 📁 guides/
  - 📄 advanced-knowledge-fabric.md 10.5 KB
  - 📄 authentication.md 35.4 KB
  - 📄 chat-websocket.md 16.2 KB
  - 📄 foundation-kit.md 34.5 KB
  - 📄 getting-started.md 10.1 KB
  - 📄 knowledge-notes.md 13.1 KB
  - 📄 multi-agent-workflow.md 17.5 KB
  - 📄 protocols.md 36.5 KB
  - 📄 workspaces.md 8.4 KB
- 📁 integrations/
  - 📄 claude-code.md 12.1 KB
  - 📄 cursor.md 9.3 KB
  - 📄 openai.md 12.7 KB
- 📁 setup/
  - 📄 installation.md 13.4 KB
📁 init/
- 📁 neo4j/
  - 📄 init.cypher 2.9 KB
📁 migrations/
- 📄 001_user_auth_provider.cypher 2.0 KB
📁 packaging/
- 📁 debian/
  - 📄 docker-compose.services.yml 1.5 KB
  - 📄 postinst 2.9 KB
  - 📄 postrm 600 B
  - 📄 prerm 448 B
  - 📄 project-orchestrator.service 669 B
- 📁 homebrew/
  - 📄 project-orchestrator.rb 2.5 KB
- 📁 rpm/
  - 📄 postinst.sh 2.5 KB
📁 scripts/
- 📄 build-desktop.sh 6.0 KB
- 📄 context.sh 850 B
- 📄 plan.sh 4.0 KB
- 📄 query.sh 1.9 KB
- 📄 seed-rfc-knowledge.sh 8.3 KB
- 📄 seed-rfc-lifecycle-protocol.sh 11.6 KB
- 📄 seed-rfc-skill.sh 5.9 KB
- 📄 seed-system-inference-protocol.sh 4.5 KB
- 📄 seed-wave-execution-protocol.sh 3.9 KB
- 📄 test.sh 5.5 KB
📁 src/
- 📁 api/
  - 📄 auth_handlers.rs 68.9 KB
  - 📄 chat_handlers.rs 50.5 KB
  - 📄 code_handlers.rs 217.9 KB
  - 📄 embedded_frontend.rs 3.0 KB
  - 📄 episode_handlers.rs 8.7 KB
  - 📄 graph_types.rs 42.6 KB
  - 📄 handlers.rs 214.6 KB
  - 📄 hook_handlers.rs 28.1 KB
  - 📄 mod.rs 630 B
  - 📄 note_handlers.rs 73.8 KB
  - 📄 profile_handlers.rs 4.6 KB
  - 📄 project_handlers.rs 72.9 KB
  - 📄 protocol_handlers.rs 52.0 KB
  - 📄 query.rs 12.3 KB
  - 📄 reason_handlers.rs 11.4 KB
  - 📄 registry_handlers.rs 9.6 KB
  - 📄 rfc_handlers.rs 67.4 KB
  - 📄 routes.rs 62.3 KB
  - 📄 skill_handlers.rs 47.5 KB
  - 📄 workspace_handlers.rs 98.5 KB
  - 📄 ws_auth.rs 29.8 KB
  - 📄 ws_chat_handler.rs 68.0 KB
  - 📄 ws_handlers.rs 24.7 KB
- 📁 auth/
  - 📄 extractor.rs 3.0 KB
  - 📄 google.rs 8.1 KB
  - 📄 jwt.rs 7.7 KB
  - 📄 middleware.rs 11.0 KB
  - 📄 mod.rs 535 B
  - 📄 oidc.rs 34.5 KB
  - 📄 refresh.rs 6.4 KB
- 📁 bin/
  - 📄 mcp_server.rs 2.4 KB
- 📁 chat/
  - 📁 stages/
    
    📄 biomimicry.rs 5.7 KB
    
    📄 file_context.rs 11.6 KB
    
    📄 knowledge_injection.rs 55.6 KB
    
    📄 mod.rs 540 B
    
    📄 pipeline_e2e_tests.rs 26.9 KB
    
    📄 skill_activation.rs 11.7 KB
    
    📄 status_injection.rs 21.9 KB
  - 📄 cli_auth.rs 6.2 KB
  - 📄 cli_version.rs 17.0 KB
  - 📄 config.rs 27.8 KB
  - 📄 continuity.rs 23.3 KB
  - 📄 enrichment.rs 23.9 KB
  - 📄 entity_extractor.rs 32.6 KB
  - 📄 feedback.rs 33.5 KB
  - 📄 manager.rs 356.0 KB
  - 📄 mod.rs 873 B
  - 📄 observation_detector.rs 23.6 KB
  - 📄 path_detect.rs 5.5 KB
  - 📄 post_tool_hook.rs 12.1 KB
  - 📄 prompt.rs 159.7 KB
  - 📄 skill_hook.rs 10.1 KB
  - 📄 types.rs 59.1 KB
  - 📄 viz.rs 45.5 KB
  - 📄 viz_builder.rs 38.6 KB
- 📁 embeddings/
  - 📄 fastembed.rs 9.9 KB
  - 📄 mock.rs 6.8 KB
  - 📄 mod.rs 895 B
  - 📄 provider.rs 9.5 KB
  - 📄 traits.rs 2.3 KB
- 📁 episodes/
  - 📄 anonymize.rs 16.7 KB
  - 📄 artifact_comparison.rs 22.3 KB
  - 📄 collector.rs 8.7 KB
  - 📄 distill.rs 16.1 KB
  - 📄 distill_models.rs 9.2 KB
  - 📄 evaluation.rs 32.3 KB
  - 📄 mod.rs 724 B
  - 📄 models.rs 16.3 KB
- 📁 events/
  - 📄 bus.rs 5.6 KB
  - 📄 graph.rs 19.7 KB
  - 📄 hybrid.rs 14.9 KB
  - 📄 mod.rs 813 B
  - 📄 nats.rs 24.7 KB
  - 📄 notifier.rs 4.8 KB
  - 📄 types.rs 15.0 KB
- 📁 graph/
  - 📄 algorithms.rs 271.8 KB
  - 📄 debouncer.rs 23.4 KB
  - 📄 engine.rs 24.4 KB
  - 📄 enrichment.rs 14.7 KB
  - 📄 extraction.rs 32.4 KB
  - 📄 mock.rs 4.3 KB
  - 📄 mod.rs 2.1 KB
  - 📄 models.rs 87.6 KB
  - 📄 process.rs 38.2 KB
  - 📄 writer.rs 16.3 KB
- 📁 identity/
  - 📄 did.rs 3.8 KB
  - 📄 mod.rs 11.2 KB
  - 📄 rotation.rs 4.9 KB
  - 📄 token.rs 8.0 KB
- 📁 mcp/
  - 📄 formatter.rs 15.3 KB
  - 📄 handlers.rs 332.5 KB
  - 📄 http_client.rs 16.3 KB
  - 📄 mod.rs 377 B
  - 📄 protocol.rs 8.5 KB
  - 📄 server.rs 9.0 KB
  - 📄 tools.rs 86.9 KB
- 📁 meilisearch/
  - 📄 client.rs 22.4 KB
  - 📄 impl_search_store.rs 5.5 KB
  - 📄 indexes.rs 7.7 KB
  - 📄 mock.rs 30.6 KB
  - 📄 mod.rs 211 B
  - 📄 traits.rs 5.3 KB
- 📁 neo4j/
  - 📄 agent_execution.rs 8.4 KB
  - 📄 analytics.rs 109.3 KB
  - 📄 batch.rs 9.0 KB
  - 📄 chat.rs 49.1 KB
  - 📄 client.rs 28.2 KB
  - 📄 code.rs 159.1 KB
  - 📄 commit.rs 14.4 KB
  - 📄 constraint.rs 7.1 KB
  - 📄 decision.rs 25.5 KB
  - 📄 feature_graph.rs 55.0 KB
  - 📄 impl_graph_store.rs 100.2 KB
  - 📄 milestone.rs 18.3 KB
  - 📄 mock.rs 434.4 KB
  - 📄 mod.rs 683 B
  - 📄 models.rs 70.2 KB
  - 📄 note.rs 109.7 KB
  - 📄 plan.rs 46.7 KB
  - 📄 plan_run.rs 9.4 KB
  - 📄 profile.rs 7.4 KB
  - 📄 project.rs 16.8 KB
  - 📄 protocol.rs 46.4 KB
  - 📄 reasoning.rs 8.8 KB
  - 📄 registry.rs 9.4 KB
  - 📄 release.rs 11.9 KB
  - 📄 skill.rs 38.4 KB
  - 📄 step.rs 8.1 KB
  - 📄 task.rs 30.6 KB
  - 📄 topology.rs 19.3 KB
  - 📄 traits.rs 108.4 KB
  - 📄 trigger.rs 9.8 KB
  - 📄 user.rs 12.4 KB
  - 📄 workspace.rs 58.8 KB
- 📁 neurons/
  - 📄 activation.rs 50.0 KB
  - 📄 config.rs 7.6 KB
  - 📄 intent.rs 11.5 KB
  - 📄 mod.rs 673 B
- 📁 notes/
  - 📄 hashing.rs 14.2 KB
  - 📄 lifecycle.rs 35.2 KB
  - 📄 manager.rs 115.0 KB
  - 📄 mod.rs 539 B
  - 📄 models.rs 45.6 KB
- 📁 orchestrator/
  - 📄 context.rs 45.9 KB
  - 📄 mod.rs 5.7 KB
  - 📄 planner.rs 121.4 KB
  - 📄 runner.rs 381.4 KB
  - 📄 topology_hook.rs 8.3 KB
  - 📄 watcher.rs 77.6 KB
- 📁 parser/
  - 📁 languages/
    
    📄 bash.rs 5.7 KB
    
    📄 c.rs 13.5 KB
    
    📄 cpp.rs 19.9 KB
    
    📄 csharp.rs 16.4 KB
    
    📄 go.rs 12.6 KB
    
    📄 hcl.rs 14.9 KB
    
    📄 java.rs 14.2 KB
    
    📄 kotlin.rs 13.0 KB
    
    📄 mod.rs 4.9 KB
    
    📄 php.rs 12.3 KB
    
    📄 python.rs 11.9 KB
    
    📄 ruby.rs 9.5 KB
    
    📄 rust.rs 17.3 KB
    
    📄 scala.rs 15.8 KB
    
    📄 swift.rs 14.1 KB
    
    📄 typescript.rs 19.6 KB
    
    📄 zig.rs 7.9 KB
  - 📄 ast_cache.rs 7.1 KB
  - 📄 helpers.rs 11.0 KB
  - 📄 mod.rs 47.3 KB
  - 📄 noise_filter.rs 25.3 KB
- 📁 plan/
  - 📄 manager.rs 63.2 KB
  - 📄 mod.rs 111 B
  - 📄 models.rs 27.8 KB
- 📁 protocol/
  - 📄 engine.rs 57.9 KB
  - 📄 generator.rs 16.3 KB
  - 📄 hooks.rs 43.4 KB
  - 📄 mod.rs 930 B
  - 📄 models.rs 47.4 KB
  - 📄 routing.rs 23.0 KB
- 📁 reasoning/
  - 📄 cache.rs 13.8 KB
  - 📄 engine.rs 40.5 KB
  - 📄 mod.rs 930 B
  - 📄 models.rs 21.9 KB
- 📁 reception/
  - 📄 anchor.rs 5.3 KB
  - 📄 mod.rs 6.7 KB
  - 📄 replay.rs 5.4 KB
  - 📄 score.rs 8.0 KB
  - 📄 trust.rs 9.3 KB
  - 📄 verify.rs 7.5 KB
- 📁 resolver/
  - 📄 mod.rs 13.5 KB
  - 📄 resolve_cache.rs 8.2 KB
  - 📄 suffix_index.rs 12.9 KB
  - 📄 symbol_table.rs 14.1 KB
- 📁 runner/
  - 📁 providers/
    
    📄 event.rs 9.4 KB
    
    📄 mod.rs 1.4 KB
    
    📄 schedule.rs 6.7 KB
    
    📄 webhook.rs 3.5 KB
  - 📄 enricher.rs 26.5 KB
  - 📄 git.rs 30.1 KB
  - 📄 guard.rs 24.7 KB
  - 📄 mod.rs 2.2 KB
  - 📄 models.rs 20.6 KB
  - 📄 persona.rs 15.5 KB
  - 📄 prompt.rs 17.3 KB
  - 📄 runner.rs 83.1 KB
  - 📄 state.rs 13.2 KB
  - 📄 trigger.rs 9.5 KB
  - 📄 vector.rs 39.8 KB
  - 📄 verifier.rs 29.5 KB
- 📁 skills/
  - 📄 activation.rs 142.2 KB
  - 📄 cache.rs 23.8 KB
  - 📄 detection.rs 50.6 KB
  - 📄 evolution.rs 47.3 KB
  - 📄 export.rs 16.8 KB
  - 📄 feedback.rs 18.1 KB
  - 📄 hook_extractor.rs 53.3 KB
  - 📄 import.rs 55.4 KB
  - 📄 lifecycle.rs 45.7 KB
  - 📄 maintenance.rs 40.1 KB
  - 📄 mod.rs 2.3 KB
  - 📄 models.rs 37.2 KB
  - 📄 naming.rs 5.3 KB
  - 📄 package.rs 44.8 KB
  - 📄 project_resolver.rs 13.5 KB
  - 📄 registry.rs 16.3 KB
  - 📄 templates.rs 20.2 KB
  - 📄 triggers.rs 68.8 KB
  - 📄 trust.rs 11.9 KB
  - 📄 validation.rs 16.3 KB
- 📁 transport/
  - 📄 http.rs 14.6 KB
  - 📄 http_handlers.rs 10.4 KB
  - 📄 mod.rs 1.0 KB
  - 📄 sync.rs 12.9 KB
  - 📄 types.rs 7.9 KB
- 📄 cli.rs 10.3 KB
- 📄 lib.rs 83.1 KB
- 📄 main.rs 8.0 KB
- 📄 setup_claude.rs 20.3 KB
- 📄 test_helpers.rs 17.3 KB
- 📄 update.rs 13.7 KB
📁 tests/
- 📄 api_tests.rs 77.7 KB
- 📄 integration_tests.rs 14.2 KB
- 📄 p2p_http_exchange.rs 21.3 KB
- 📄 p2p_integration.rs 17.5 KB
- 📄 parser_tests.rs 39.5 KB
- 📄 workspace_tests.rs 42.1 KB
📄 .env.example 838 B
📄 .env.production.example 2.4 KB
📄 .gitignore 358 B
📄 AGENTS.md 4.3 KB
📄 Cargo.lock 151.3 KB
📄 Cargo.toml 6.7 KB
📄 CLAUDE.md 29.4 KB
📄 codecov.yml 1.9 KB
📄 config.yaml.example 9.4 KB
📄 CONTRIBUTING.md 4.8 KB
📄 Cross.toml 1.5 KB
📄 docker-compose.production.yml 4.7 KB
📄 docker-compose.yml 3.1 KB
📄 Dockerfile 6.4 KB
📄 install.ps1 5.0 KB
📄 install.sh 5.8 KB
📄 LICENSE 357 B
📄 LICENSE-EE 3.0 KB
📄 LICENSE-MIT 1.0 KB
📄 README.md 29.5 KB
📄 SKILL.md 10.8 KB

SKILL.md

---
name: project-orchestrator
description: AI agent orchestrator with Neo4j knowledge graph, Meilisearch search, and Tree-sitter parsing. Use for coordinating multiple coding agents on complex projects with shared context and plans.
metadata:
  clawdbot:
    emoji: "🎯"
    requires:
      bins: ["docker", "cargo"]
---

# Project Orchestrator

Coordinate multiple AI coding agents with a shared knowledge base.

## Features

- **Multi-Project Support**: Manage multiple codebases with isolated data
- **Neo4j Knowledge Graph**: Code structure, relationships, plans, decisions
- **Meilisearch**: Fast semantic search across code and decisions
- **Tree-sitter**: Precise code parsing for 16 languages
- **Plan Management**: Structured tasks with dependencies and constraints
- **MCP Integration**: 22 mega-tools for Claude Code, OpenAI Agents, and Cursor
- **Authentication**: Google OAuth2, OIDC, and Password login + JWT with deny-by-default security
- **Chat WebSocket**: Real-time conversational AI via Claude integration
- **Event System**: CRUD event notifications via WebSocket
- **NATS Integration**: Inter-process event sync for multi-instance deployments
- **YAML Configuration**: Hierarchical config with env var overrides

## Documentation

- [Installation Guide](docs/setup/installation.md)
- [Getting Started Tutorial](docs/guides/getting-started.md)
- [API Reference](docs/api/reference.md)
- [MCP Tools Reference](docs/api/mcp-tools.md)
- Integration Guides: [Claude Code](docs/integrations/claude-code.md) | [OpenAI](docs/integrations/openai.md) | [Cursor](docs/integrations/cursor.md)

## Quick Start

### 1. Start the backends

```bash
cd {baseDir}
docker compose up -d
```

### 2. Build and run the orchestrator

```bash
cargo build --release
./target/release/orchestrator serve
```

Or with Docker:
```bash
docker compose up -d
```

### 3. Sync your codebase

```bash
# Via CLI
./target/release/orch sync --path /path/to/project

# Via API
curl -X POST http://localhost:8080/api/sync \
  -H "Content-Type: application/json" \
  -d '{"path": "/path/to/project"}'
```

## Usage

### Create a project

```bash
# Create a new project
curl -X POST http://localhost:8080/api/projects \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Embryon",
    "root_path": "/Users/triviere/projects/embryon",
    "description": "Neural network composition framework"
  }'

# List all projects
curl http://localhost:8080/api/projects

# Sync a project
curl -X POST http://localhost:8080/api/projects/embryon/sync

# Search code within a project
curl "http://localhost:8080/api/projects/embryon/code/search?q=tensor&limit=10"
```

### Create a plan

```bash
orch plan create \
  --title "Implement GPU Backend" \
  --desc "Add Metal GPU support for neural network operations" \
  --priority 10
```

### Add tasks to the plan

```bash
orch task add \
  --plan <plan-id> \
  --desc "Implement MatMul Metal shader"

orch task add \
  --plan <plan-id> \
  --desc "Add attention layer GPU support" \
  --depends <task-1-id>
```

### Get context for an agent

```bash
# JSON context
orch context --plan <plan-id> --task <task-id>

# Ready-to-use prompt
orch context --plan <plan-id> --task <task-id> --prompt
```

### Record decisions

```bash
orch decision add \
  --task <task-id> \
  --desc "Use shared memory for tile-based MatMul" \
  --rationale "Better cache locality, 2x performance improvement"
```

### Search past decisions

```bash
orch decision search "memory management GPU"
```

## API Endpoints

### Projects (Multi-Project Support)

| Method | Path | Description |
|--------|------|-------------|
| GET | `/api/projects` | List all projects |
| POST | `/api/projects` | Create a new project |
| GET | `/api/projects/{slug}` | Get project by slug |
| DELETE | `/api/projects/{slug}` | Delete a project |
| POST | `/api/projects/{slug}/sync` | Sync project's codebase |
| GET | `/api/projects/{slug}/plans` | List project's plans |
| GET | `/api/projects/{slug}/code/search` | Search code in project |

### Plans & Tasks

| Method | Path | Description |
|--------|------|-------------|
| GET | `/health` | Health check |
| GET | `/api/plans` | List active plans |
| POST | `/api/plans` | Create plan |
| GET | `/api/plans/{id}` | Get plan details |
| PATCH | `/api/plans/{id}` | Update plan status |
| GET | `/api/plans/{id}/next-task` | Get next available task |
| POST | `/api/plans/{id}/tasks` | Add task to plan |
| GET | `/api/tasks/{id}` | Get task details |
| PATCH | `/api/tasks/{id}` | Update task |
| GET | `/api/plans/{plan}/tasks/{task}/context` | Get task context |
| GET | `/api/plans/{plan}/tasks/{task}/prompt` | Get generated prompt |
| POST | `/api/tasks/{id}/decisions` | Add decision |
| GET | `/api/decisions/search?q=...` | Search decisions |

### Sync & Watch

| Method | Path | Description |
|--------|------|-------------|
| POST | `/api/sync` | Sync directory to knowledge base |
| GET | `/api/watch` | Get file watcher status |
| POST | `/api/watch` | Start watching a directory |
| DELETE | `/api/watch` | Stop file watcher |
| POST | `/api/wake` | Agent completion webhook |

### Code Exploration (Graph + Search)

| Method | Path | Description |
|--------|------|-------------|
| GET | `/api/code/search?q=...` | Semantic code search |
| GET | `/api/code/symbols/{path}` | Get symbols in a file |
| GET | `/api/code/references?symbol=...` | Find all references to a symbol |
| GET | `/api/code/dependencies/{path}` | Get file import/dependent graph |
| GET | `/api/code/callgraph?function=...` | Get function call graph |
| GET | `/api/code/impact?target=...` | Analyze change impact |
| GET | `/api/code/architecture` | Get codebase overview |
| POST | `/api/code/similar` | Find similar code snippets |
| GET | `/api/code/trait-impls?trait_name=...` | Find types implementing a trait |
| GET | `/api/code/type-traits?type_name=...` | Find traits implemented by a type |
| GET | `/api/code/impl-blocks?type_name=...` | Get all impl blocks for a type |

## Auto-Sync with File Watcher

Keep the knowledge base updated automatically while coding:

```bash
# Start watching a project directory
curl -X POST http://localhost:8080/api/watch \
  -H "Content-Type: application/json" \
  -d '{"path": "/path/to/project"}'

# Check watcher status
curl http://localhost:8080/api/watch

# Stop watching
curl -X DELETE http://localhost:8080/api/watch
```

The watcher automatically syncs `.rs`, `.ts`, `.tsx`, `.js`, `.jsx`, `.py`, `.go` files when modified.
It ignores `node_modules/`, `target/`, `.git/`, `__pycache__/`, `dist/`, `build/`.

## Code Exploration

Query the code graph instead of reading files directly:

```bash
# Semantic search across code
curl "http://localhost:8080/api/code/search?q=error+handling&language=rust&limit=10"

# Get symbols in a file (functions, structs, etc.)
curl "http://localhost:8080/api/code/symbols/src%2Flib.rs"

# Find all references to a symbol
curl "http://localhost:8080/api/code/references?symbol=AppState&limit=20"

# Get file dependencies (imports and dependents)
curl "http://localhost:8080/api/code/dependencies/src%2Fneo4j%2Fclient.rs"

# Get call graph for a function
curl "http://localhost:8080/api/code/callgraph?function=handle_request&depth=2&direction=both"

# Analyze impact before changing a file
curl "http://localhost:8080/api/code/impact?target=src/lib.rs&target_type=file"

# Get architecture overview
curl "http://localhost:8080/api/code/architecture"

# Find similar code patterns
curl -X POST http://localhost:8080/api/code/similar \
  -H "Content-Type: application/json" \
  -d '{"snippet": "async fn handle_error", "limit": 5}'

# Find all types implementing a trait
curl "http://localhost:8080/api/code/trait-impls?trait_name=Module"

# Find all traits implemented by a type
curl "http://localhost:8080/api/code/type-traits?type_name=Orchestrator"

# Get all impl blocks for a type
curl "http://localhost:8080/api/code/impl-blocks?type_name=Neo4jClient"
```

## For Agents

### Getting context before starting work

```bash
# Fetch your task context
curl http://localhost:8080/api/plans/$PLAN_ID/tasks/$TASK_ID/prompt
```

### Recording decisions while working

```bash
curl -X POST http://localhost:8080/api/tasks/$TASK_ID/decisions \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Chose X over Y",
    "rationale": "Because..."
  }'
```

### Notifying completion

```bash
curl -X POST http://localhost:8080/api/wake \
  -H "Content-Type: application/json" \
  -d '{
    "task_id": "'$TASK_ID'",
    "success": true,
    "summary": "Implemented feature X",
    "files_modified": ["src/foo.rs", "src/bar.rs"]
  }'
```

## Configuration

Environment variables:

| Variable | Default | Description |
|----------|---------|-------------|
| `NEO4J_URI` | `bolt://localhost:7687` | Neo4j connection URI |
| `NEO4J_USER` | `neo4j` | Neo4j username |
| `NEO4J_PASSWORD` | `orchestrator123` | Neo4j password |
| `MEILISEARCH_URL` | `http://localhost:7700` | Meilisearch URL |
| `MEILISEARCH_KEY` | `orchestrator-meili-key-change-me` | Meilisearch API key |
| `WORKSPACE_PATH` | `.` | Default workspace path |
| `SERVER_PORT` | `8080` | Server port |
| `RUST_LOG` | `info` | Log level |

## Architecture

```
┌─────────────────────────────────────────────────────────────┐
│                    ORCHESTRATOR API                          │
│                    (localhost:8080)                          │
└─────────────────────────────┬───────────────────────────────┘
                              │
        ┌─────────────────────┼─────────────────────┐
        ▼                     ▼                     ▼
┌───────────────┐     ┌───────────────┐     ┌───────────────┐
│    NEO4J      │     │  MEILISEARCH  │     │  TREE-SITTER  │
│   (7687)      │     │    (7700)     │     │   (in-proc)   │
│               │     │               │     │               │
│ • Code graph  │     │ • Code search │     │ • AST parsing │
│ • Plans       │     │ • Decisions   │     │ • Symbols     │
│ • Decisions   │     │ • Logs        │     │ • Complexity  │
│ • Relations   │     │               │     │               │
└───────────────┘     └───────────────┘     └───────────────┘
```

## Development

```bash
# Run tests
cargo test

# Run with debug logging
RUST_LOG=debug cargo run -- serve

# Format code
cargo fmt

# Lint
cargo clippy
```

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

project-orchestrator

Directory Structure

SKILL.md

Report

Notice