Devmark 0.2.0 · Local work notes for developers

Keep your progress.
Find your next step.

Keep the progress that matters, and the ideas for later.
Capture with the CLI. Pick up the context in a native app.
Turn your work into a daily recap when you need one.

Get Devmark for macOS Explore the CLI

Devmark Journal in English: tags sorted by usage on the left, milestone cards in the middle, and the selected entry’s Markdown on the right. — Native app · Sample data · English UI

Keep moving. Keep the context.

A place for the milestones you reach and the things you want to come back to.

Journal

Remember meaningful progress

Record milestones, decisions, releases, and deployments. See what changed and why when you look back.

Todos

Save it now. Come back later.

Capture a side task before you lose the thought. Check it off when it’s done; completing a todo never creates a journal entry.

Tags & search

Find it without remembering where

Connect work across projects with tags, then find it with keyword search. Project paths are optional metadata.

Devmark Todos in English: Open, Done, and All filters with counts, todo cards, tags, and Markdown details. — Native Todos view · Sample data · English UI

Follow the thought.
Finish it later.

Side tasks show up while you’re working. Add a quick todo from the menu bar: one sentence, a few #tags, and you’re back to the task at hand.

Choose an existing tag or add a new one
Edit in the app with multiline titles and Markdown details
Switch between Open, Done, and All, with matching counts

Devmark menu bar quick capture in English: a short reminder followed by #ux and #follow-up. — One sentence. #tags sorted automatically.

Recaps · A daily summary, when you need it

A day’s work.
Ready to share.

Choose a date, time zone, and tag, then select journal entries and todos completed that day. Draft a recap with your ChatGPT plan, review and edit it, then copy or export it as Markdown.

Generate only when you ask; nothing runs automatically in the background
Optionally include open todos as follow-up items
Save recaps with source snapshots and reopen them from history

Use Continue with ChatGPT to connect an eligible account without an API key. Generation uses your ChatGPT plan allowance or available credits. Only selected content is sent; Devmark does not read your ChatGPT or Codex conversations.Check eligibility with OpenAI ↗

Devmark Recaps in English: history on the left and a daily summary on the right, with editing, copy, and Markdown export controls. — Native Recaps view · English UI · Authored sample, not a live AI result

Language

Work in a familiar language

The app supports English, Simplified Chinese, and Traditional Chinese. It follows your system language, falls back to English, and lets you switch in Settings.

Backup & export

Take your records with you

Back up the full database in Settings, or export Journal, Todos, and Recaps as JSON. Individual recaps can also be exported as Markdown.

Your connection

Keep credentials separate

ChatGPT credentials stay in macOS Keychain, outside database backups. Tokens are checked and refreshed only when you request a recap.

Capture where you work

From the terminal
to your app.

For you and your coding agent. Pass in JSON, and the CLI and app share the same local records.

Run inside a project to infer its path automatically. Reuse the same event_key when retrying a Journal command to avoid duplicate entries.

devmark list --tag uxFind entries by tag

devmark todo list --status openFind open todos

devmark add --json - <<'JSON'
{
  "kind": "milestone",
  "summary": "Completed search and tag filters",
  "details": "Added keyword search and tag filtering.",
  "tags": ["devmark", "ux"],
  "event_key": "search-and-tags-v1"
}
JSON

devmark todo add --json - <<'JSON'
{
  "title": "Add a helpful empty state for search",
  "details": "Keep the active filters and offer a way to clear them.",
  "tags": ["ux", "follow-up"]
}
JSON

Devmark × coding agents

Connect your coding agent

Give your agent a small set of standing instructions. Load the skill only when it needs Devmark commands.

Add this to your AGENTS.md or CLAUDE.md. It defines when to record progress and when to leave a reminder.

## Devmark

Use Devmark to remember meaningful development progress and deliberately deferred work.

- Record completed implementation phases, releases, deployments, migrations, and accepted decisions that materially change scope, architecture, or operations. Record blocker changes only when they materially affect milestone progress.
- Skip routine turns, checks, reviews, commits, and discussions. If an event does not clearly qualify, skip it.
- Create a Todo only when the user asks for a reminder or has explicitly chosen to defer that work. Recording a Todo does not authorize executing it. Completing or reopening a Todo must not create a Journal entry.
- Run from the relevant project directory so Devmark can infer its path. Use the user's preferred language for records and the user's active timezone.
- Confirm each write succeeds. Reuse the same `event_key` and unchanged payload when retrying a Journal event; never silently replace a conflicting event.
- Consult the Devmark skill for commands and JSON examples. If it is unavailable, use `devmark --help` or `devmark todo --help`. If the CLI is missing or a write fails, report it without claiming success and continue unrelated work.

Download prompt ↓

SKILL.md

Command details, only when needed

A self-contained Markdown skill with the recording policy, complete JSON examples, and commands for Journal and Todos.

Meaningful milestones, not a log of every turn
Project paths, tags, search, and Todo completion
Verified writes and clear retry rules

Download skill (.md) ↓

Save it as devmark/SKILL.md inside your agent’s skills directory. The directory location depends on your agent.

Install Devmark CLI on PATH first. The prompt and skill are English in both website languages; your records can use your preferred language.

Your records. Your computer.

One local SQLite database, shared by the CLI and app.
No account or server is needed for everyday records. Export or back them up whenever you like.
Selected content is sent to OpenAI only when you use the optional ChatGPT recap feature.

Leave a mark for what’s next.

Start on macOS. Make Devmark part of your workflow.

Native desktop app

Devmark 0.2.0 for macOS

Apple Silicon · Three app languages · Quick capture and recaps

Download App ZIP

Notarized by Apple. Unzip and move Devmark.app to Applications.
Currently validated on macOS Apple Silicon only.

For terminals and agents

Pair it with Devmark CLI

Download the CLI and install it in your command directory.

Download CLI for macOS Apple Silicon

mkdir -p "$HOME/.local/bin"
unzip -q ~/Downloads/devmark-cli-0.2.0-macos-arm64.zip -d ~/Downloads
install -m 755 ~/Downloads/devmark-cli-0.2.0-macos-arm64/devmark "$HOME/.local/bin/devmark"
export PATH="$HOME/.local/bin:$PATH"
devmark --help

The CLI is Developer ID signed and Apple notarized; its ticket is checked online. The app and CLI share the same database by default.

SHA-256 checksums ↓

Keep your progress.Find your next step.