Manage tickets, releases, wiki pages, and test cases without leaving your repo. Everything is plain YAML under .gitoza-lite/ — browse and edit it from a structured UI in VS Code, then share work with your team through git and branches like any other code.
Open a project, click through tickets, edit and save, search, and plan by release:
Ask Cursor, Copilot, or ChatGPT to draft a ticket the same way you’d ask for a code change. The assistant writes a YAML file in the repo; open it in Gitoza Lite to refine status, release, and details — then commit and review in a PR. No built-in AI required.
- Draft with AI — generate a
.yamlfile, then open and refine it in Gitoza Lite before you commit. - Docs and tasks as code — every entity is a file you can
git add,git diff, and merge in pull requests. - Same file shape everywhere — YAML front matter + Markdown body; filename stem is the entity id.
Browse the Test Repository, create a case, and run a manual Pass / Fail / Skip flow:
This repository ships both extension source and a seeded handbook under .gitoza-lite/ (wiki, tickets, test cases, and a smoke run). The handbook is repo demo data only — it is excluded from the published .vsix.
- Clone this repository and open the folder in VS Code.
- Install Gitoza Lite from the Marketplace, or pressF5 (Run Extension ) from a development checkout — the host opens
.dev/handbook-workspace(symlinked handbook) so it does not jump back to the parent window. - Run Gitoza Lite: Open Tickets, Wiki & Tests (or click the Gitoza Lite Activity Bar icon).
- Start here:
- Wiki →
02-getting-started→Welcome — open this handbook (W-LITE01) - Tickets → projectGitoza_Lite →Welcome — start here (
LITE-WELCOM) - Test Repository → projectgitoza.lite.handbook
- Test Run →R-SMOKE1 (Handbook smoke)
Requirements: VS Code 1.85+ and an open workspace folder.
- Open a repository in VS Code.
- The Gitoza Lite tab opens in the editor area when the extension activates (when a
.gitoza-lite/root exists, or after you run the open command). - If the tab was closed, click the Gitoza Lite icon in the Activity Bar, or runGitoza Lite: Open Tickets, Wiki & Tests from the Command Palette.
- Use the left icon rail to switch between Test Repository ,Test Run ,Tickets ,Releases , andWiki .
- Create a first project (tests or tickets) or wiki page from the empty state to initialize the matching folder under
.gitoza-lite/.
Workspace paths: This extension uses .gitoza-lite/ only. It does not read or modify Gitoza Desktop paths under .gitoza/. Copy or move files manually if you already have Desktop data — there is no automatic migration.
| Module | Path |
|---|---|
| Test cases | .gitoza-lite/test/cases/ |
| Test runs | .gitoza-lite/test/run/ |
| Tickets | .gitoza-lite/tasks/tickets/{project}/ |
| Releases | .gitoza-lite/tasks/tickets/{project}/releases/ |
| Wiki | .gitoza-lite/wiki/ |
- Tickets — two-column project tree + detail; create tickets with auto ids (
PREFIX-XXXXXX); edit metadata + Markdown - Releases — project-scoped release YAML; link from ticket
releasefield - Wiki — two-column folder/page tree + detail; immutable
W-…page ids; title/tags/status + Markdown - Test Repository — three-column UI for projects, suites, and cases
- Test Run — YAML-backed manual runs with Pass / Fail / Skip
- Local-first — reads and writes YAML on disk; no SQLite or cloud dependency
- Manual save — Edit, then Save (no auto-save)
---
title: Fix login redirect
type: bug
status: open
priority: high
tags: [auth]
---
## Description
…
Path: .gitoza-lite/tasks/tickets/{project}/{PREFIX}-{id}.yaml. Project meta: .project.yaml with ticket_prefix.
---
release_id: demo/1.1.0
name: 1.1.0
status: open
---
Path: .gitoza-lite/tasks/tickets/{project}/releases/{stem}.yaml.
---
title: Architecture overview
tags: [handbook]
status: published
---
Markdown body…
Path: .gitoza-lite/wiki/{folders…}/W-XXXXXX.yaml.
Each test case is a YAML file with front matter and a Markdown body. The extension writes only editable fields on create/save (title, priority, tags, status, requirement_id, assigned_to, automated, params, and the Markdown body).
---
title: Login with valid credentials
priority: high
tags: [smoke, auth]
status: active
---
## Steps
1. Open the login page
2. Enter valid credentials
## Expected result
User is redirected to the dashboard.
---
title: Sprint 42 smoke
---
cases:
- path: .gitoza-lite/test/cases/my_project/suite/login.yaml
result: pending
- path: .gitoza-lite/test/cases/my_project/suite/logout.yaml
result: passed
Supported result values: pending, passed, failed, skipped.
Built by Gitoza. Tickets, wiki, releases, and tests stay the same YAML shape whether you edit them in VS Code or elsewhere.
Gitoza Lite is the in-editor workflow for developers. When the whole team needs to work on that same project data — including people who don’t live in git day to day — keep assets local and use Gitoza Desktop for shared task views, sync, and progress tracking.
See CONTRIBUTING.md for build, test, and packaging instructions.
MIT — see LICENSE.