Quick start

Getting started

Install Manta, initialize your project, and run your first commands in under five minutes.

1. Install Bun

   Manta requires Bun.

   curl -fsSL https://bun.sh/install | bash
   bun --version

2. Install Manta

   bun install -g manta-it

   Or from source: clone the repo, then bun install and bun link.

3. Initialize your project

   cd your-project
   mt init

4. Create and view an issue

   mt create "My first issue" --priority p1
   mt view

   Use the ID from create for update/close/delete commands.

Where your data lives

Manta creates .manta/ in your current working directory:

Identity on issues

createdBy and updatedBy are set automatically from your OS username (USER / USERNAME). You never type them manually.

Sync with teammates

After git pull updates .manta/manta.jsonl:

• Every command refreshes the cache automatically before it runs — including mt view, so your list is always up to date.
• mt sync is available if you ever want to rebuild the cache on its own.