Create Your First Agent

1. Create a New Agent

Agents begin as simple definitions — a name, a purpose, and a model. Over time, they grow into collaborators that understand your world.

To create your first agent, run:

playnex agent create

You’ll be asked a few questions:

• Name: what you want to call your agent
• Purpose: what the agent is meant to do
• Model: which local or cloud model it should use

---

2. Define the Agent’s Purpose

Purpose is the soul of an agent. It tells the model how to behave, what to prioritize, and how to interpret your requests.

Here’s an example purpose:

You are a writing assistant. 
You help refine ideas, draft paragraphs, and improve clarity. 
You write with warmth, precision, and a calm tone.
      

You can edit this later — agents evolve as your needs evolve.

---

3. Add Tools (Optional)

Tools give your agent abilities beyond text generation — browsing, writing files, analyzing documents, running scripts, and more.

To add a tool:

playnex agent add-tool my-agent

You’ll be guided through selecting tools from the Playnex tool library.

---

4. Run Your Agent

Once created, you can talk to your agent directly:

playnex agent chat my-agent

This opens a conversational shell where your agent can think, plan, and act.

---

5. Save Work Into Capsules

Agents can store drafts, notes, research, and reflections into capsules — your personal knowledge containers.

Try asking your agent:

“Save this idea as a new capsule.”

Capsules become the memory layer of your workspace — a place where ideas accumulate and grow.

You’ve now created your first agent — a small intelligence that lives with you, ready to help you think and create.