TaskMan is a task and project management app built for people who want to stay organized without drowning in their tools. It combines a clean task board with daily check-ins, a focus mode that cuts out the noise, AI-assisted delegation, and a gamification layer that makes finishing work feel like progress — because it is.
The hosted version is available at taskman.app. This repository is public for transparency and self-hosting. If you are an end user of the hosted service, you do not need anything here — head to the User Manual instead.
- Task & project management with Kanban, table, calendar, and week views
- Daily check-in to set priorities, track energy, and log blockers
- Focus mode — one screen, your top three tasks, nothing else
- AI agent delegation — hand off research, writing, code, and outreach tasks to AI agents (Pro/Team)
- Calendar sync — subscribe to your tasks in Google Calendar, Outlook, or Apple Calendar via iCal
- Gamification — XP, levels, streaks, and achievements that reward consistent work
- Team collaboration — role-based access, shared projects, activity logs, and a creator dashboard
- API & webhooks — integrate with your own tools using personal API keys
TaskMan is designed to run on any container platform. The quickest path is Docker Compose.
- Docker and Docker Compose
- A Resend API key (for password reset emails)
- A Stripe account if you want billing features (optional for personal use)
git clone https://github.com/your-org/taskman.git
cd taskmancp backend/.env.example backend/.envOpen backend/.env and set the required values:
JWT_SECRET= # generate with: openssl rand -base64 32
RESEND_API_KEY= # from resend.com — required for password reset
CORS_ORIGIN= # your frontend URL, e.g. http://localhost:3000If you are not using billing features, you can leave the STRIPE_* variables empty. The app will run without them — the billing page simply will not function.
docker-compose up --buildThis starts three services:
| Service | Default port |
|---|---|
| Frontend | http://localhost:3000 |
| Backend API | http://localhost:4000 |
| PostgreSQL | localhost:5432 |
Database migrations run automatically on first start. Open http://localhost:3000 and create your account.
If you want iCal feed URLs to point to a public domain rather than localhost, set:
CALENDAR_PUBLIC_URL=https://your-backend-domaingit pull
docker-compose up --buildMigrations are applied automatically during startup.
TaskMan is free to use for individuals. Paid plans unlock AI agent delegation, team collaboration features, and higher resource limits. See the full comparison at taskman.app/billing.
| Free | Pro ($8/mo) | Team ($6/user/mo) | |
|---|---|---|---|
| Tasks & projects | Unlimited | Unlimited | Unlimited |
| Collaborators | 1 (view-only) | Unlimited | Unlimited |
| AI agent delegations | — | 50 / month | 200 / month (shared) |
| API keys | — | 5 | 25 |
| Webhooks | — | 5 | 25 |
| File attachments | — | 100 MB / project | 500 MB / project |
| Activity log | 30 days | Unlimited | Unlimited |
| Creator dashboard | — | — | Included |
- User Manual — comprehensive guide for end users
- Deployment Guide — Railway-specific deployment walkthrough
See LICENSE for details.