# Trackwell

> Issue tracking with workflows, sprints, SLAs and team roles, in your browser. Trackwell is a ticket and issue tracker for software teams, IT service desks and anyone with a backlog: projects with keys like WEB-123, seven issue types, your own fields and workflows, scrum and kanban boards, a query language, dashboards and business-hour SLAs. It works locally without an account, and with Teamspaces your team shares projects live with admin, member, viewer and guest roles — guests can submit requests and see only their own.

Trackwell (Issue tracker) is an app of usefulweb.app (https://usefulweb.app/): a full program that runs in the browser. Its engine is deterministic and the same functions are exposed as tools, so an agent can compute exactly what the app shows.

## Use it
- Landing page: https://trackwell.usefulweb.app/
- Workspace (browser app): https://trackwell.usefulweb.app/app - open a project with https://trackwell.usefulweb.app/app#project=<base64url-encoded project JSON> or a template with https://trackwell.usefulweb.app/app#template=<id>
- Project file format (JSON Schema): https://trackwell.usefulweb.app/project.schema.json
- Tutorials: https://trackwell.usefulweb.app/tutorials
- JSON API: POST https://trackwell.usefulweb.app/api/v1/tools/<toolId>/calculate (catalog: https://trackwell.usefulweb.app/api/v1/tools)
- OpenAPI: https://trackwell.usefulweb.app/openapi.json
- MCP (Streamable HTTP): https://trackwell.usefulweb.app/mcp

## Engine tools
- [Trackwell Query Filter](https://trackwelljqlfilter.usefulweb.app/): Filter an exported issue list with a JQL-style query: status, assignee, dates, ORDER BY. Part of [Trackwell](https://trackwell.usefulweb.app/) (ownerApp: trackwell). API: POST https://trackwell.usefulweb.app/api/v1/tools/trackwell-jql-filter/calculate · MCP tool `trackwell_jql_filter`
- [Trackwell SLA Calculator](https://trackwellslacalculator.usefulweb.app/): When is a ticket due in business hours? Working days, holidays, pauses and breaches. Part of [Trackwell](https://trackwell.usefulweb.app/) (ownerApp: trackwell). API: POST https://trackwell.usefulweb.app/api/v1/tools/trackwell-sla-calculator/calculate · MCP tool `trackwell_sla_calculator`
- [Trackwell Sprint Burndown](https://trackwellburndown.usefulweb.app/): Sprint burndown and burnup from a Trackwell project or a table of sprint items. Part of [Trackwell](https://trackwell.usefulweb.app/) (ownerApp: trackwell). API: POST https://trackwell.usefulweb.app/api/v1/tools/trackwell-burndown/calculate · MCP tool `trackwell_burndown`
- [Trackwell Jira CSV Import](https://trackwelljiracsvimport.usefulweb.app/): Turn a Jira CSV export into a Trackwell project: issues, statuses, sprints, people. Part of [Trackwell](https://trackwell.usefulweb.app/) (ownerApp: trackwell). API: POST https://trackwell.usefulweb.app/api/v1/tools/trackwell-jira-csv-import/calculate · MCP tool `trackwell_jira_csv_import`

## Formats
- Import: Trackwell project (.trackwell.json), Jira CSV export (all fields), Trackwell CSV export, Teamspaces documents (shared projects)
- Export: Trackwell project (.trackwell.json), Issues as CSV (Jira-compatible columns), Work log as CSV for Timeslice, Charts as SVG, Archive documents of resolved issues

## Limits
- No e-mail notifications or e-mail-to-ticket: notifications live inside the app.
- Project roles follow the workspace roles and per-project access rules; transition role rules are checked in the app, not by the server.
- SLA calendars use a fixed UTC offset; daylight saving changes are not applied automatically.
- A shared project is one document (at most 2 MB); very large projects need resolved issues moved to archive documents.
- No swimlanes, roadmaps/timelines or automation rules yet.
- Jira CSV imports cannot bring attachments, full work logs or change history, because Jira’s CSV export does not contain them.