tiki

tiki

tiki is a simple and lightweight way to keep your tasks, prompts, documents, ideas, scratchpads in your project git repo

Software development and AI assisted development in particular leaves a lot of Markdown files around - project management, documentation, brainstorming ideas, incomplete implementations, AI prompts and plans and what not. Stick them in your repo. Keep around for as long as you need. Find them back in git history. Make tasks out of them and take them through an agile lifecycle

Installation

Mac OS and Linux

curl -fsSL https://raw.githubusercontent.com/boolean-maybe/tiki/main/install.sh | bash

Mac OS via brew

# Add the tap (one-time)
brew tap boolean-maybe/tap

# Install tiki
brew install tiki

Windows

# Windows PowerShell
iwr -useb https://raw.githubusercontent.com/boolean-maybe/tiki/main/install.ps1 | iex

Manual install

Download the latest distribution from the releases page and simply copy the tiki executable to any location and make it available via PATH

Verify installation

tiki --version

Quick start

cd into your git repo and run tiki. Move your tiki around the board with Shift ←/Shift →. Make sure to press ? for help. Press F1 to open a sample doc root. Follow links with Tab/Enter

AI skills

You will be prompted to install skills for

• Claude Code
• Codex
• Opencode

if you choose to you can mention tiki in your prompts to create/find/edit your tikis

Happy tikking!

tiki

Keep your tickets in your pockets!

tiki refers to a task or a ticket (hence tiki) stored in your git repo

• like a ticket it can have a status, priority, assignee, points, type and multiple tags attached to it
• they are essentially just Markdown files and you can use full Markdown syntax to describe a story or a bug
• they are stored in .doc/tiki subdirectory and are git-controlled - they are added to git when they are created, removed when they are done and the entire history is preserved in git repo
• because they are in git they can be perfectly synced up to the state of your repo or a branch
• you can use either the tiki CLI tool or any of the AI coding assistant to work with your tikis

doki

Store your notes in remotes!

doki refers to any file in Markdown format that is stored in the .doc/doki subdirectory of the git repo.

• like tikis they are git-controlled and can be maintained in perfect sync with the repo state
• tiki CLI tool allows creating multiple doc roots like: Documentation, Brainstorming, Prompts etc.
• it also allows viewing and navigation (follow links)

tiki CLI tool

tiki CLI tool allows creating, viewing, editing and deleting tikis as well as creating custom plugins to view any selection, for example, Recent tikis, Architecture docs, Saved prompts, Security review, Future Roadmap Read more by pressing ? for help

AI skills

tiki adds optional agent skills to the repo upon initialization If installed you can:

• work with Claude Code, Codex, Opencode by simply mentioning tiki or doki in your prompts
• create, find, modify and delete tikis using AI
• create tikis/dokis directly from Markdown files
• Refer to tikis or dokis when implementing with AI-assisted development - implement tiki xxxxxxx
• Keep a history of prompts/plans by saving prompts or plans with your repo

Feedback

Feedback is always welcome! Whether you have an improvement request, a feature suggestion or just chat:

• use GitHub issues to submit and issue or a feature request
• use GitHub discussions for everything else

to contribute: Contributing

Badges