opencode-todo

KO | EN

gitlite — search

#mysql #dotnet #swift #api #ai-agent #csharp #tailwindcss #windows #data-science #database

(★ 9)

A personal task backlog for OpenCode, for you, not the agent.

파일 탐색기

ZIP 다운로드

- tui.json
- demo.gif
- consts.ts
- display.ts
- server.ts
- store.ts
- tui.tsx
- display.test.ts
- server-plugin.test.ts
- store.test.ts
.gitignore
.oxlintrc.json
AGENTS.md
LICENSE
opencode.json
package-lock.json
package.json
README.md
tsconfig.json

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

A personal task backlog for [OpenCode](https://opencode.ai), for you, not the
agent.

![Adding, running, and clearing tasks](https://raw.githubusercontent.com/ainformatico/opencode-todo/main/assets/demo.gif)

## The problem

You're watching an agent refactor the auth middleware when it hits you: "after
this, I should also fix the retry logic, update the docs, and finally rename
that terrible function."

You can't send that message. Send it mid-run and the agent cheerfully derails
into all three tasks at once, and now nothing works, including the thing that
was working two minutes ago.

So you hold it in your head. Then you open a second session in another git
worktree, which spawns its own follow-ups, and your head runs out of RAM.

`opencode-todo` is the sticky note that fixes that: custom commands, a live
**"My Backlog"** panel in the sidebar, one JSON file on disk. That's the whole
plugin. It is deliberately the simplest thing that works.

## Install

```sh
opencode plugin opencode-todo --global
```

Restart opencode. Done. Requires OpenCode 1.18+; drop `--global` for a
project-local install.

## Commands

| Command | What it does |
|---|---|
| `/todo-add` | Type a task into a dialog. It's on the list. |
| `/todo-run` | Pick a task → it loads into your composer, marked done. You press Enter. |
| `/todo-remove` | Pick a task → delete it. |
| `/todo-edit` | Pick a task → fix that typo. Editing a completed task puts it back to pending. |
| `/todo-list` | Print this session's tasks (first 10). |
| `/todo-clear` | Empty this session's list, after a confirmation dialog. |

All dialog-driven, no arguments, no model turns, pure bookkeeping. Commands
appear in `/` autocomplete once installed; nothing else to set up.

## For you, not the agent

- **The agent never sees your tasks.** Nothing is auto-executed, auto-drained,
  or auto-anything. `/todo-run` loads a task into the composer and stops
  there; sending it is your Enter press. Running a task marks it done
  (`✓`); items leave the list only when you remove or clear them.
- **Session-scoped.** Each session sees only its own list, numbered per
  session, so each worktree keeps its own next-steps. Delete the session and
  its list goes with it.
- **Collapsible sidebar.** With more than 2 items, click the "My Backlog"
  header to collapse/expand (count shown while collapsed); the state sticks
  across restarts.
- **One JSON file.** State lives in `.opencode/queue.json`: human-readable,
  atomic writes, survives restarts. Corrupt files are quarantined
  (`queue.json.corrupt-<ts>-<rand>`), never silently overwritten. You
  probably want it in your project's `.gitignore`, task text can be
  sensitive. Zero infrastructure, by design.

## Development

```sh
npm test && npm run lint && npm run typecheck
```

For local hacking: `opencode.json` → `{ "plugin": ["./src/server.ts"] }`,
`.opencode/tui.json` → `{ "plugin": ["../src/tui.tsx"] }`. MIT licensed.

opencode-todo

오너의 다른 레포

파일 탐색기

# CDN으로 사용하기

Was this content helpful?

Recent Feedback

opencode-todo

오너의 다른 레포

파일 탐색기

# CDN으로 사용하기

Was this content helpful?

Recent Feedback

Download README