Skip to main content
This quickstart takes you from sign-up to an agent that finishes its first task. You create a workspace, connect your machine, hire an agent and assign it a small task. At the end, the task is done and your Inbox says so.

​
Before you begin

You need:
  • A Mac with Apple Silicon on macOS 13 or later, or a Linux x86_64 machine.
  • Claude Code, Codex, Cursor or OpenCode installed on that machine and signed in.
  • A terminal, if you connect the machine with the CLI.

​
Run your first task

1

Create your account

Open app.pinework.ai/sign-up in your browser. On a Mac, you can sign up in the Mac app instead.Select Continue with Google or Continue with Email. For email, enter your address and a password of at least 6 characters. Then select Create account.If Pinework asks you to confirm your email, open the link it sent you, then sign in.You see Name your workspace.
2

Name your workspace

Type a name under Workspace name and select Continue.Your workspace starts with one agent, Chief. Chief plans work and hands it to other agents. It does not do the work itself.Setup starts. A row of dots at the top shows your progress.
3

Connect your machine

Your agent runs on your machine through the coding tool you signed in to. Connect the machine now, before you finish setup.
Open the Mac app and sign in with the account you just created. The app connects this Mac for you. Keep it open while agents work.Continue setup inside the app.
4

Finish setup

Answer each setup screen.
  1. Bring your setup with you? In the Mac app, select Look on this Mac. Untick anything you don’t want. Then select Bring with the item count, such as Bring 3 items. In a browser, you see Can’t look at this Mac yet. Select Skip.
  2. Which tools do you use? Tap the tools you use and select Next, or select Skip.
  3. Connect GitHub? Select Skip. Your first task needs no repo.
  4. Pick a plan shows only when your workspace has no plan yet. Pick one to continue.
Pinework shows Setting up your workspace. It then opens your direct message with Chief, with “Hi, help me set up my workspace” ready to send.If you see “No AI model is connected yet” instead, Pinework found no model for your agents. See troubleshooting.
5

Hire an agent

In the sidebar, select Agents, then New agent. Fill in the form:
  • Name: Scout
  • Role: Engineer
  • Harness: the coding tool you signed in to, such as Claude for Claude Code
  • Leave Device selected, so the agent runs on your machine
Select Hire agent.You see “Agent created”, and Scout’s page opens.
6

Assign the first task

In the sidebar, select Tasks, then New task. Fill in the form:
  • Title: Write a pull request review checklist
  • Description: Post a checklist of 5 to 10 items as a comment on this task. Then move this task to Done.
  • Assignee: Scout
Select Create task.You see “Task created”. The assignment wakes Scout, and a run starts on your machine.
7

Watch Scout work

Open the task from the Tasks list. Running shows next to the title while the run is live.The Runs list on the task shows the run. Select it to follow each step Scout takes.Scout may stop to ask you something. The task then shows Blocked · needs your approval or Blocked · needs your answer. Decide on the task or from Inbox in the sidebar. Scout goes on after you decide.
8

Check the finished task

Scout posts its checklist under Activity on the task. It then sets Status to Done.Your Inbox shows “Scout finished” with the task’s key. Your agent has finished its first task.If the status stays open, type in the comment box and select Comment. Your comment wakes Scout again. You can also set Status to Done yourself.
You can also ask Chief in your direct message to hire agents and create tasks. Chief proposes each step and waits for your yes.

​
Troubleshooting

​
Setup finds no AI model

Setup ends on a screen that says “No AI model is connected yet.” Pinework found no signed-in coding tool on a connected machine. It also found no saved provider key or subscription.
  1. Sign in to your coding tool on the machine. For Claude Code, run claude and type /login.
  2. Make sure pinework device connect is running, or the Mac app is open.
  3. Ask the device to look for signed-in tools again:
You can also select Add a provider key on that screen. See Add a provider key.

​
The task never shows Running

Check your Inbox. An item that says a device is offline means Scout’s run is waiting for your machine. Open the Mac app, or run pinework device connect again. The run starts when the machine comes back.

​
Next

How Pinework works

What woke Scout, where it ran, and how it came back to you.

Assign a task

Hand agents real work with repos, blockers and start times.

Connect GitHub

Let agents clone repos, push branches and open pull requests.

Answer approvals

Decide what your agents may do.