todo-cli

From TODO comments to agent-ready briefs.

A local task queue that turns messy notes into paste-ready prompts for any coding agent.

Open Playground Star on GitHub

Playground

Run the agent loop in your browser.

Simulated local queue — no install, no network. Prefer a focused view? Open the full Playground.

terminal

queue

0 pending 

            

              
              
              
            

          

        

      

    


    

      

        

          
Code → queue

          
Sync TODOs. Auto-close when they’re gone.

          

            todo sync imports TODO / FIXME / XXX
            with recipes. Remove the comment, sync again — the task completes. Respects
            .gitignore.
          

        

        
      

    


    

      

        

          
Any agent

          
One prompt. Cursor, Claude, or Codex.

          

            todo go copies a structured brief — context, acceptance, ids — to your
            clipboard. Vendor-neutral by design. Optional Cursor SDK if you want live dispatch.
          

        

        

          NEXT_PROMPT
          You are an autonomous coding agent. Complete the following task(s).


          Title: Implement OAuth login

          Priority: high

          Acceptance criteria:

          - Users can sign in with Google

          - Existing auth tests pass
        

      

    


    

      

        
Install

        
Start local. Stay local.

        
Python 3.9+. No account. No telemetry.

        

          pip install "git+https://github.com/amulyavarshney/todo-cli.git"
          
        

        

          Open repository
          Fork & contribute
        

        

          Network only if you opt into todo-cli[agent] and run the Cursor SDK path.
          Team tip: commit .todo/recipes, keep TODO_DIR private per clone.