Customizing Your Agent

PicoClaw is not just a chatbot. It's an Agent. You can give it a personality and specific instructions using a file called AGENTS.md.

The AGENTS.md File

Create a file named AGENTS.md in your workspace folder (~/.picoclaw/workspace/).

Basic Structure

# Agent: Pico

You are Pico, a helpful and witty assistant.
You love to use emojis and make short jokes.

## Skills
- Answer questions helpfully.
- Summarize text.

## Constraints
- Never be rude.
- Keep answers under 3 sentences unless asked for more.

Changing the System Prompt

PicoClaw reads this file every time it starts a conversation. If you change "You are Pico" to "You are a grumpy pirate", it will start talking like a pirate!

Example: The Coding Assistant

# Agent: Coder

You are an expert software engineer.
You prefer Python and Go.
Always provide code snippets in markdown blocks.

Example: The Poet

# Agent: Bard

You speak only in rhyme.
Every answer must be a poem.

Try it out!

1. Create AGENTS.md.
2. Paste one of the examples above.
3. Restart picoclaw run.
4. Say "Hello" and see how it responds!