How Hark works

Bring in your existing work in one of three ways: paste a conversation you had with an AI tool, connect a GitHub repo, or start blank. Hark reads it and suggests what it found — decisions, the next action, open blockers — each linked to the exact passage or commit it came from.

Nothing is filed until you say so. Where the source doesn't say something, Hark shows "Not found in the source" instead of guessing.

Every project has one short answer to "where does this stand?": what's done, what's in progress, the next action, and anything blocking it. Anything a person hasn't confirmed yet is marked "Not yet confirmed" with a Confirm button, so you always know what's agreed and what's a guess.

With a repo connected, merged pull requests and releases show up as things that actually happened — useful when no one has written an update in a while.

The Decisions list shows only what's been accepted. Suggestions — from an import, an agent, or a teammate — wait in a review list until someone accepts or rejects them, and they never look like decisions in the meantime.

When a decision changes, the new one replaces the old, and the old one stays visible as a one-line history — so nobody works from an outdated call. You can also keep both if they genuinely both apply.

When someone else needs to pick up the work, choose who it's for — a developer, a client, or an agent. Before you send, Hark checks for gaps (a decision with no reason, no next action) and lets you fix each one in a click.

The recipient gets a link. They can read it for free, ask questions you answer in place, and add their own notes as suggestions for you to review — without taking a seat on your plan. Client handoffs only ever show confirmed, client-facing items. You can revoke a link any time.

Connect Hark to the AI tools you already use — Claude Code, Codex, Cursor, ChatGPT, Grok, VS Code, Windsurf and more. Most take a button or one line. Once connected, every tool reads the same current state before it starts and leaves a note when it's done, so the next one picks up where the last left off. It's optional — Hark works fine with no AI at all.

Set up your tools → · See agent features →

A handoff only helps if it actually gets written. Five things make sure it does:

• Sessions are locked to one project — An agent working on V-004 can't read or write V-009 without an explicit switch — and blocked attempts are logged.
• Nothing ends without a note — If a session goes quiet, Hark drafts the handoff from what actually happened; the next agent sees it first.
• Agent memory is reviewable — Decisions and state changes proposed by agents wait for your accept or reject; they never enter the brief or your public project page unreviewed.
• The brief is short by default — Phase, next action, last decisions, blockers, non-goals — with the full project page on request.
• Your handoff lives in your repo too — With export on, Hark commits .hark/HANDOFF.md, .hark/DECISIONS.md, and an AGENTS.md block, so the brief survives even if Hark is unreachable.

Projects are private by default. You can share a link without listing it anywhere, or make a project public in Open Studio, the gallery of builds in progress.

Your projects live in a workshop. Invite teammates as owner, admin or member (each takes a seat), or as a guest who sees only the projects you share and can comment — guests and handoff recipients never take a seat.

Browse Open Studio →

If you run many projects at once, turn on Advanced structure from your user menu. It adds a six-stage board for moving ideas from rough notes to shipped:

• Vault — Raw ideas & sparks
• Recon — Research & validation
• Blueprint — Spec & design
• Fabrication — Building
• Live — Shipped & operating
• Cold Storage — Paused / shelved

It also adds a fuller project page (business, build and branding notes), links, numbers, and an activity view. See the features page for details. You can turn it off again any time; nothing is lost.

Every new workshop starts with a free 14-day trial and no card — solo workshops on Builder, teams on Studio. Hark is named for the Harkness table, where every seat is equal and every idea gets heard.

• Builder — $19.99/mo · For the solo builder with too many ideas.
• Studio — $49/mo · For small teams and founders working with others.
• Agency — $100/mo · For studios shipping for clients.
• Enterprise — For organisations that need it on their terms.

Do I have to set everything up before Hark is useful?

No. Paste one conversation or connect one repo, confirm what Hark found, and you have a current state and a decision list you can hand off. Everything else is optional.

What stops an AI tool from mixing up two of my projects?

Each working session is locked to one project. A tool working on one project can't read or change another without an explicit switch, and blocked attempts are logged.

What if an AI tool never leaves a handoff note?

If a session goes quiet, Hark drafts the note from what actually happened and marks it as a draft. The next person or tool sees it first.

Can an AI tool change my project without me seeing it?

No. Anything an AI tool suggests waits for you to accept or reject it. Nothing unreviewed shows up as a decision, in a handoff, or on a public page.