Check whether your repository is ready for agents

Unstoppable desktop 1.1.0 checks each Code workspace for setup and launch scripts, hooks and agent instructions, and can have an agent add what is missing.

An agent working in a fresh worktree needs a few things a developer usually carries in their head: how to install dependencies, how to start the app, what to do when a commit check fails, and the conventions of the repository. Version 1.1.0 of the Unstoppable desktop app checks each Code workspace for those pieces and offers to have an agent add the ones that are missing.

What the check looks for

Open Overview from the sidebar. The Workspace readiness section, "Suggestions for deeper integration with your repositories." lists each Code workspace whose repositories are missing something. It checks three things in every repository:

  • Setup and launch scripts. A setup script prepares a new worktree, for example by installing dependencies, and a launch script starts the app. When both are missing, the recommendation reads Add setup and launch scripts; when one is missing, it names that one.
  • Repository hooks. Hooks let the app act on events such as a failed commit check or a pull request event. With none configured, it suggests Add repository hooks.
  • Agent instructions. Claude Code reads CLAUDE.md and Codex reads AGENTS.md. With neither file at the repository root, it suggests Initialize agent instructions. With only one, it suggests Link agent instructions, so both agents get the same guidance.

When nothing is missing, the section says that all Code workspaces have setup and launch scripts, hooks, and shared agent instructions in place. The same recommendations appear in a workspace's settings, on the Details tab.

Diagram: Workspace readiness checks each repository for setup and launch scripts, repository hooks, and agent instructions in both CLAUDE.md and AGENTS.md. Fix in new worktree starts an agent chat in its own worktree for one missing piece. The check confirms the pieces exist, not that they work.

Fix one item in a new worktree

Each recommendation has a Fix in new worktree button. It creates a worktree, starts a chat there with instructions for that one fix and the app's built-in configuration skill, and leaves the Overview where it is. The button then becomes View conversation, which opens the chat.

The instructions ask the agent to read the repository before editing anything: build manifests, the README, continuous integration workflows and the commands developers use.

  • Scripts: it adds the missing setup or launch commands to unstoppable-code.json, the repository's source-controlled configuration, and validates the file.
  • Agent instructions: it keeps an existing file as the source and links the other to it, with a symlink on macOS and an identical copy on Windows. With neither file, it writes a concise CLAUDE.md with the real build, lint and test commands and the conventions an agent would otherwise get wrong, then adds AGENTS.md.
  • Hooks: it looks at the repository's checks and pull request conventions first, and uses a conservative default set when the repository doesn't show what it needs.

Because the work happens in its own worktree, your current checkout isn't touched while the agent works.

Where it stops

The check covers Code workspaces only; Cowork workspaces are skipped. It looks for whether scripts, hooks and instruction files exist, not whether they work: a launch script that fails still counts as present. What the agent writes is a proposal from reading the repository, so check it before you rely on it.

Ryan Le built workspace readiness.

Try it

Workspace readiness is in version 1.1.0 of the Unstoppable desktop app. Download it, add a repository as a Code workspace, then open Overview.

Cookie preferences

Optional cookies measure ads and improve the site with session recordings. Change anytime. Privacy policy