What you can do with Bloks

5 use cases

• Keep a coding agent working until tests pass

  Give an agent a goal and a check command, and let it loop turn by turn until the check passes.

  • Bloks
  • Claude Code
  • Codex
  • Gemini CLI
  • Personal productivity
  • Intermediate
  View prompt

  Using the Bloks repo at hamedgitty/bloks, start a /goal in the agent conversation for the project at <project-folder>, with the check pnpm test. Expected output: the goal reports done, stuck or out of turns, and the test run result. Verify that pnpm test passes in <project-folder> before you call the goal done.

  Share Save

• Rehearse a risky file change before it touches your folder

  Let an agent do a task on a copy of your folder, compare attempts, and apply only the one you want.

  • Bloks
  • Claude Code
  • Codex
  • Gemini CLI
  • Personal productivity
  • Intermediate
  View prompt

  Using the Bloks repo at hamedgitty/bloks, rehearse the task <task-description> on a copy of the folder <target-folder> with the agent in Bloks. Expected output: a change card listing each changed file with its line count and diff, with Apply and Discard buttons. Verify that the real folder <target-folder> is unchanged until you press Apply.

  Share Save

• File incoming documents from a folder automatically

  Point an agent at a folder with a rule, so new files are handled the moment they land.

  • Bloks
  • Personal productivity
  • Intermediate
  View prompt

  Using the Bloks repo at hamedgitty/bloks, set up a watcher on the folder <incoming-folder> that files new invoices into <filing-folder>. Expected output: a watcher entry plus a change card for each filed file. Verify that the first look only created a baseline and that the first real file was filed as your rule says.

  Share Save

• Read what your agents did overnight in one brief

  Get a morning summary of agent work, pending approvals and daily cost, with links to each source.

  • Bloks
  • Personal productivity
  • Intermediate
  View prompt

  Using the Bloks repo at hamedgitty/bloks, enable the morning brief and run one routine for the agent <agent-name>. Expected output: a morning brief listing what <agent-name> did, what is waiting on you and the day's cost, with a link for each line. Verify that each line links to a real conversation or file.

  Share Save

• Back up your whole agent workspace and restore it

  Seal a backup with a passphrase, check it, and restore it without losing what it replaces.

  • Bloks
  • Personal productivity
  • Intermediate
  View prompt

  Using the Bloks repo at hamedgitty/bloks, create a sealed backup of the workspace and check it. Expected output: a backup file that the check reports as valid. Verify that the check passes and that you have the passphrase stored outside the backup.

  Share Save

How to use Bloks

1. Check you have what it needs: The Bloks desktop app installed on your machine; At least one provider you can use: a Claude Code, Codex or Gemini CLI you already signed in to, or an API key for a chat engine; A project folder or files the agent is allowed to work in.
2. Open hamedgitty/bloks on GitHub and read the README and license.
3. Open the agent's conversation in Bloks and pick the project folder it works in.
4. Type /goal in the message box and describe what done looks like, for example: all tests in the project pass.
5. Add the check to the goal: pnpm test
6. Watch the turn chip above the composer; use Pause if you want to stop the loop.

These steps come from our top use case, Keep a coding agent working until tests pass, which also has a copy-paste agent prompt.

Bloks alternatives · Best AI repos for Personal productivity

About this repo

• Who it is forPeople who want several AI agents working on their own files and tasks, and who want to approve, undo and review what those agents do.
• Why it is hot
• LanguageTypeScript
• Sourcegithub.com/hamedgitty/bloks · Back to Hot repos

Requirements

• The Bloks desktop app installed on your machine
• At least one provider you can use: a Claude Code, Codex or Gemini CLI you already signed in to, or an API key for a chat engine
• A project folder or files the agent is allowed to work in
• For the iPhone steps: the Bloks iPhone app and a six digit pairing code from your Mac

Related repos

• Trended earlier Abacusai Bot AbacusAI Bot is a free, open-source desktop app for creating standing personal agents that you can message from WhatsApp, Telegram, Discord, or the desktop and connect to work services.
• Trended earlier Unigit Ecosystem UNIGIT's public brand and ecosystem hub, which explains the product direction and gives builders, partners, and users a way to recommend resources and propose partnerships.
• Trended earlier Comma Comma is an open-source, always-on personal agent that turns goals into persistent Tasks, runs them in agent loops, and works across your computers, phone, and cloud.