Create your first project

One command builds your whole project, agent included. You'll run it, then look at the handful of folders it created so you know where your agent lives.

Create the project

From any folder, run:

stackbone init my-first-agent --with agent
cd my-first-agent
pnpm install

Here's what each part does:

• stackbone init my-first-agent creates a new folder called my-first-agent. This folder is your project: it can hold many agents and workflows side by side.
• --with agent puts one ready-made agent inside, so you have something to run right away.
• pnpm install downloads the packages your agent needs.

You need to be signed in for this, which you did on the previous page. The command also connects the project to your account so you can ship it later.

Look at what you got

Open the my-first-agent folder in your editor. The parts that matter for now:

my-first-agent/
  deep-agents/    ← your agents live here, one folder each
  workflows/      ← workflows go here (empty for now)
  package.json    ← the project's packages

Your new agent is the folder under deep-agents/. That folder is where you'll change what the agent says and does later. You don't need to touch anything yet.

Think of the project as the container and the agent as one thing living inside it. Right now there's one agent and no workflows. You'll add a workflow near the end of this guide.

What's next

• Run and chat with your agent: start it locally and say hello.