Write Markdown
Issues, project docs, and members live as editable files with small YAML headers and readable bodies.
Plain files. Git history. Agent-ready workflows.
Project tracking you can read in a text editor.
TLDR: Gitlear is a local-first issue, project, and docs format stored as Markdown in Git, with CLI, GUI, and MCP tooling layered on top.
What It Is
Gitlear is a project workspace format. The source of truth is a regular directory tree: workspace metadata, members, projects, issues, docs, and status labels are all Markdown files.
No hosted tracker is required for the project record. Git gives you history, branches, review, sync, and recovery using tools you already have.
How It Works
Commit to Git
Every change is a normal commit, so collaboration, rollback, and review use the same flow as code.
Use Any Surface
The CLI, desktop GUI, and local MCP server read and write the same files instead of a hidden database.
Let Agents Help
Agents can inspect the format directly or use the MCP server to work with issues and project state.