New

Just launched: Vueblocks, a brand-new search engine for Vue packages! Explore Vueblocks →

hadrien-shifumi/taskr

Minimalist, multi-tenant issue tracker built for humans and AI agents alike — self-hostable, MCP-native, powered by Laravel, Inertia and React.
4 2
Install
composer require hadrien-shifumi/taskr
Latest Version:v0.2.0
PHP:^8.3
Laravel:13
License:MIT
Last Updated:Nov 13, 2026
Links: GitHub  ·  Packagist
Maintainer: hadrien-shifumi

TaskR

TaskR

TaskR is a minimalist ticket tracker for teams who want to track issues, time and project health — without agile ceremony, issue types or configurable workflows. Just workspaces, projects and issues.

It's built to be driven by humans through the web UI and by AI agents through a built-in MCP server, with the same rules and permissions on both sides.

✨ What you get

  • Workspaces & projects — multi-tenant, invite teammates by email, strict data isolation. Each project tracks progress, overdue issues and hours logged vs. estimated, with an on track / at risk / late projection.
  • Issues your way — Markdown descriptions, priorities, free-form labels, multiple assignees, parent/child hierarchy, dependencies between issues, and statuses you define yourself (no imposed workflow).
  • Comments & notifications — @mentions, a mentions inbox, and an optional email digest.
  • Time tracking — estimates and time entries, right on the issue.
  • Knowledge base — Markdown pages with history, version comparison and restore, plus semantic search powered by any OpenAI-compatible embeddings endpoint.
  • API & MCP — personal access tokens and a stateless MCP server (~50 tools) so an AI agent can manage your workspace just like a human would.
  • French & English, switchable per user.

🚀 Try it in a few minutes

git clone https://github.com/hadrien-shifumi/TaskR.git && cd TaskR
cp .env.example .env   # set APP_KEY, e.g. `openssl rand -base64 32`
docker compose up -d

Open http://localhost:8080 — that's it, PostgreSQL and the app are both running.

Prefer a classic PHP setup instead of Docker, or want to hack on the code? See docs/installation_EN.md (or _FR) for local development, or docs/self-hosting_EN.md (or _FR) for a production deployment (Docker Compose, composer create-project, updates, external database…).

Tech stack

Layer Technologies
Backend PHP 8.5, Laravel 13, Octane (FrankenPHP), PostgreSQL + pgvector, Sanctum, laravel-actions
Frontend Inertia v3, React 19, TypeScript, Tailwind CSS v4, shadcn/ui, TipTap
Testing Pest — Unit, Feature and Browser (Playwright E2E) suites

Driving TaskR from AI agents (MCP)

  1. Create a token in Settings → API tokens (shown only once).
  2. Point your agent at POST /mcp with Authorization: Bearer <token>.

The server exposes ~50 tools (workspaces, projects, issues, comments, time tracking, knowledge base…). Start with list_workspaces, then pass the workspace_id to every other tool.

Example client configuration (OpenCode):

{
  "mcp": {
    "servers": {
      "taskr": {
        "type": "remote",
        "url": "https://taskr.example.com/mcp",
        "oauth": false,
        "headers": { "Authorization": "Bearer {env:TASKR_MCP_TOKEN}" }
      }
    }
  }
}

Testing

composer test        # Pest: Unit + Feature suites
composer test:e2e    # Browser suite (Playwright, desktop + mobile viewports)

This project follows a mandatory TDD workflow — see AGENTS.md and .opencode/skills/tdd.

Documentation & conventions

Repository

github.com/hadrien-shifumi/TaskR

Related Packages

lattice-php/lattice

Server-driven React components for Laravel and Inertia.

10,377 0
nwanguma/atlas

Laravel React Inertia Tailwind starter kit

275 90
leafs/inertia

Leaf PHP adapter for inertia JS

1,492 1
lucky-media/reactor

Minimal Laravel authentication scaffolding with React, Inertia and Tailwind CSS.

568 65
sunrice/admin

An admin panel framework for Laravel: auth, users and roles, resources, custom R...

243 0

Version History

Version Released PHP Laravel License
v0.2.0 ^8.3 ^13.17 MIT
v0.1.2 ^8.3 ^13.17 MIT
v0.1.1 ^8.3 ^13.17 MIT
v0.1.0 ^8.3 ^13.17 MIT