DocsGet Started

Quick Start

Learn the Agentastic workspace and launch a safe first task in a few minutes

This tour assumes Agentastic and at least one provider CLI are already installed. If not, start with Installation.

Open a repository#

Use any of these entry points:

Press Cmd+O in Agentastic.
Drag a folder onto the Agentastic icon.
Run open -a "Agentastic.dev" /path/to/repository.

A git repository unlocks the normal worktree-per-task workflow. Non-git folders can still use local or container mode.

Know the workspace#

Area	What it is for
Navigator	Files, repositories, source control, and the Agents list
Editor	Code, diffs, browser previews, settings, and Agent Home
Utility area	Native terminals, task output, and logs
Inspector	Worktree status, changes, browser state, agents, commit, and pull-request actions

Useful shortcuts:

Action	Shortcut
Quick Open	`Cmd`+`P`
Command Palette	`Cmd`+`Shift`+`P`
Toggle Navigator	`Cmd`+`0`
Toggle Utility Area	`Cmd`+`J`
Find in Project	`Cmd`+`Shift`+`F`

Launch a focused task#

Open Agent Home.
Choose the repository and base branch.
Select an installed provider.
Leave the isolation mode on Worktree.
Enter a task such as:

text

Add a health-check endpoint that returns the app version.
Follow the existing route pattern and add focused tests.
Run those tests before you finish.

Send the prompt.

Agentastic creates a branch and worktree, runs any configured setup script, launches the provider's CLI, and delivers your prompt.

Follow the work#

The new task appears in the Agents navigator. From there you can:

Watch its terminal output.
Open changed files in the editor.
Launch the worktree's development server.
Preview and inspect the result in the built-in browser.
Send a follow-up when the agent is waiting for input.

The main repository remains untouched because the task has its own checkout.

Review and finish#

When the agent stops:

Open the worktree's diff.
Run or inspect the relevant tests.
Optionally run code review with Claude, Codex, CodeRabbit, or Greptile.
Commit and open a pull request from the Inspector or source-control actions.
Archive or remove the worktree after the change is merged.

Try the dev CLI#

After installing shell integration from Agentastic → Install Shell Integration…, launch a task from any terminal:

bash

dev agent create \
  --repo ~/src/my-app \
  --agent codex \
  --name docs-cleanup \
  --prompt "Tighten the installation guide and check every internal link."

Then inspect and message it:

bash

dev agents
dev tail <terminal_id> 80
dev send <terminal_id> "Also verify the examples on macOS 14."

See Programmatic Control for scripts, schedulers, dashboards, and bot integrations.

Go deeper#

Your First Agent — the full task lifecycle
Multi-Agent Programming — split independent work safely
Browser — preview and automate a worktree
Diff Viewer — review before merge