my-agent

A workshop project for building a custom CLI agent using Fast-Agent.

The objective is to build an agent which is capable of reading and writing files in the local file system, execute commands in the terminal, and use web search to gather information.

Implement the agent using the Fast-Agent framework and Claude Code's architecture as the inspiration to create a custom agent that can act as a partner for software development tasks and automation.

setup repo

Click Use this template and Create a new repository to create a copy of this repo under your username; then checkout the repo:

git checkout https://github.com/myusername/my-agent.git

installation

First install the package manager uv.

macOS and Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Then sync the packages:

uv sync

usage

Run the agent with:

uv run agent.py

This will start the agent, which will interact with you via the command line.

useful references

• Claude Code system prompt - May 2025
• Claude Code Built-in Tools Reference
• Claude system prompts

useful services

• SerpAPI - for web search tool with API
• Serper - another web search tool with API

useful mcp servers

• Desktop Commander
• Filesystem
• Sequential Thinking
• Public APIs

hints

- Fast-Agent website has an [llms.txt](https://fast-agent.ai/llms.txt) file that will help your AI understand how it works and how to write code for it.

# claude code

If you want to use Claude Code, follow installation instructions [here](https://claude.com/product/claude-code).

Then copy the .env.example file to .env:
```bash
cp .env.example .env

Then copy the key found in the #trac25-my-agent channel, paste it into .env file as:

ANTHROPIC_API_KEY=your_key_here

Then run claude with:

claude

Follow the prompts to interact with the agent.