@umudik/task-bridge
v0.0.5
Published
Task Bridge — self-hosted API + web UI server, runnable via npx.
Downloads
602
Readme
task-bridge
Epic ve task yönetimi için tek backend, web paneli ve Android uygulaması.
Projeler workflow stage’leri üzerinden ilerler; mobil veya web’den task açılır, yorumlar inbox’a düşer, worker kuyruğu otomasyon/agent tarafından tüketilir.
Repo
| Dizin | Ne |
|-------|-----|
| apps/backend | Fastify API, SQLite, worker queue |
| apps/web | React dashboard (Vite) |
| apps/mobile | Android (Kotlin + Compose) |
| apps/mcp | MCP server for AI agents |
Geliştirme
copy .env.example .env
npm install
npm run dev| Servis | URL | |--------|-----| | Web UI | http://localhost:5173/app/login | | API | http://localhost:3000 |
İlk kurulumda web’den /setup ile admin oluştur, sonra /app/login.
npx ile çalıştır
Build edilmiş API + web tek paket olarak npm'de (@umudik/task-bridge):
npx @umudik/task-bridge| Opsiyon | Açıklama |
|---------|----------|
| -p, --port <port> | Dinlenecek port (varsayılan 3000 / $PORT) |
| -d, --data <dir> | SQLite veritabanı dizini (varsayılan ./task-bridge-data) |
npx @umudik/task-bridge --port 8080 --data ./tb-dataAç: http://localhost:3000/app/login — ilk açılışta /app/setup ile admin oluştur. Veritabanı çalıştırdığın klasörde task-bridge-data/bridge.db olarak kalır.
API (agent / otomasyon)
OpenAPI 3.1 spec backend’de yaşar ve çalışan sunucudan JSON olarak okunur:
GET /api/docsKaynak: apps/backend/src/openapi.ts
MCP (AI agents)
Cursor / Claude Desktop → apps/mcp/README.md
Stdio MCP server; Task Bridge API’yi tool olarak sunar. .cursor/mcp.json örneği repoda.
Deploy & mobil
Sunucu (API + web) → npx @umudik/task-bridge (yukarıdaki npx bölümü)
Web UI detayları → apps/web/README.md
Android → apps/mobile/README.md
License
MIT
