Quickstart with a coding agent

Use this alternative to the dashboard quickstart when you want your coding agent to prepare your factory. Your agent creates the Machine, Agents, and Line while you review the plan.

Before you begin

Have a terminal, a local coding agent that supports skills, and a GitHub account with access to the repository you want to work on. You need an Islo account, available credits, and Machines enabled for your account. An organization owner may need to approve the GitHub app before a run can start.

Connect GitHub and install the skills

islo login --tool github
npx skills add islo-labs/skills

For ticket workflows, also connect Linear with islo login --tool linear. See Authentication for connection scope.

Ask your agent to prepare a Line

Replace the repository and PR number in this copyable prompt:

Use the Islo factory-lines skill to create a manual Line that reviews a pull request in acme/api. Select my factory, prepare and verify a Machine, create the review Agent, validate the Line, and show me the deployment plan. After I review it, deploy the Line, start a run for pull request 123, and return the run ID.

The agent checks the installed islo schema factory and islo schema agent definitions while producing the files. Review its Agent, Machine, trigger, and stage choices before deployment. The factory model explains factory selection; Machines explains build verification.

Inspect the run

Use the run ID your agent returns:

islo factory line-run status <run-id>
islo factory line-run events <run-id>

Status shows the current stage. Events show what happened at each transition. You can disconnect while agents work and return later. Open Runs in the dashboard and select the run for Timeline and Chat.

What you’ll see

Your agent returns a deployment plan and, after you approve deployment, a run ID. If the Machine is not ready, follow the agent’s build verification instructions. For missing integrations, credits, or GitHub approval, see the quickstart blockers.

Pick a goal to go deeper

Fix a bug

Turn a confirmed bug into a pull request.

Deliver a feature

Ship a planned ticket with review and verification.

Build your own Line

Choose your Agents, stages, and triggers.

Read How Islo works, Agents, Machines, and Triggers to tune the workflow. Operate a run covers intervention, and Delegations covers requests from Slack, GitHub, and Linear after your factory is ready.