Search

    MENU

    A kanban workflow
    in the terminal

    npm i -g @zinn-dev/clizinn --help

    Zinn: a kanban CLI for your terminal

    Zinn is an Experimental task manager for you and the agents you work with.

    Each project is a board of columns and tasks. You and your agents create, move and comment on the same tasks with the same commands, and all of it lives in one SQLite database on your machine.

    Start a project. Move the work.

    Create a project, add a task, then move it into Doing. Each project begins with Backlog, TODO, Doing, Review, Done and Cancelled columns, which you can rename or extend.

    Descriptions hold the scope and comments the updates. Labels and priorities organize the work, and related, dependency, duplicate and subtask relations connect it. Search covers titles, descriptions and comments, and archiving hides finished tasks from active lists.

    			
    				
    						
    						zinn project create DEMO --name 'Release work'
    					
    						
    						zinn task create DEMO \
      --title 'Write release notes' \
      --priority high
    					
    						
    						zinn task move DEMO-1 Doing
    					
    						
    						zinn task list DEMO --json
    					
    			
    		

    Give a task a deadline with --due, then sort by it with task list --sort due or select a range with --due-since and --due-until. task move, task archive and task delete take several tasks at once. --description-file and --text-file read text from a file or stdin, and --limit with --starting-after continues a long list.

    Work alongside your agents

    Zinn doesn't stop at who changed a task. It takes you back into the conversation that made the change.

    Activity records the agent and session behind a change, and zinn activity list --task <task-key> lists the changes to a task. Claude Code and Codex sessions are recorded without setup.

    The Zinn workflow skill teaches an agent to find its task, keep context in comments, record follow-ups and hand off at the project's review column. Set it up for your agent.

    For scripts, --json prints one JSON document on stdout. A failure exits with code 1 and writes a JSON error to stderr, so scripts can match its code. zinn capabilities --json describes every command's inputs, effects and result schemas, and --yes confirms prompts. Read scripting and JSON output for the details.

    Keep the work local

    Every project lives in one SQLite database, ~/.zinn/data/zinn.sqlite by default. Keep it elsewhere with settings.

    zinn backup saves a database snapshot, and zinn restore puts one back after saving the current database. A newer release upgrades an older database after making a backup. Read data and backups for the details.

    Take the next command

    Zinn is free and MIT licensed. See its price in bytes and running costs.

    Read the quick start or project reference, browse the Zinn source on GitHub or find the Zinn CLI package on npm.