Getting Started with TeamDay

This guide walks you through signing up, creating your first AI agent, and having your first conversation. You'll be up and running in a few minutes.

Sign Up

  1. Visit teamday.ai and click Sign Up
  2. Authenticate with Google, GitHub, or Email
  3. An organization is created for you automatically

Once signed in, you land on the main dashboard where you can create Spaces, add Characters, and start chatting.

Core Concepts

Before building, here's how TeamDay is organized:

ConceptWhat It Is
SpaceA workspace (project directory) where agents run. Contains files, installed tools, skills, and secrets.
CharacterA full AI persona — with a name, role, system prompt, model, skills, and MCP integrations. Characters power conversations.
AgentA lightweight entity — just a name, role, and system prompt. Quick to create for simple tasks.
SkillA reusable capability that teaches agents how to do specific tasks (e.g., generate images, write reports).
MCP ServerA tool integration that connects agents to external services (Google Analytics, Ahrefs, Slack, etc.).
MissionA scheduled task — run an agent on a cron schedule, once at a future time, or continuously.

Characters and Agents both appear as "team members" you can chat with. The key difference is Characters carry richer configuration (skills, MCP references, marketing content, categories) while Agents are minimal and fast to create.

Create Your First Space

Spaces are where agents do their work. Every conversation runs inside a Space.

  1. Click + New Space from the dashboard
  2. Give it a name (e.g., "My First Project")
  3. Choose a type:
    • Empty — blank workspace
    • Git — clone from a GitHub repository
  4. Click Create

Your Space starts with a sandbox directory where agents can read and write files, run commands, and use installed tools.

Via CLI:

teamday spaces create --name "My First Project"

Create Your First Agent

The quickest way to get started is to create a lightweight Agent.

In the Web App

  1. Navigate to your Space
  2. Open the Agent Picker (the agent selector in the chat interface)
  3. Click + Create Agent
  4. Set the basics:
    • Name: "My Assistant"
    • Role: "General Assistant"
    • System Prompt: "You are a helpful assistant. Be concise and friendly."
  5. Start chatting immediately

Via CLI

teamday agents create \
  --name "My Assistant" \
  --role "General Assistant" \
  --system-prompt "You are a helpful assistant. Be concise and friendly."

Via API

curl -X POST "https://us.teamday.ai/api/v1/agents" \
  -H "Authorization: Bearer $TEAMDAY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Assistant",
    "role": "General Assistant",
    "systemPrompt": "You are a helpful assistant. Be concise and friendly."
  }'

Chat With Your Agent

In the Web App

Open your Space and select your agent from the chat panel. Type a message and press Enter. The agent streams its response in real time.

Agents in TeamDay are powered by Claude and have access to a full set of tools:

  • Read, Write, Edit — work with files in the Space
  • Bash — run shell commands
  • WebSearch, WebFetch — search the web and fetch pages
  • Glob, Grep — find and search files

These tools let agents do real work — not just answer questions.

Via CLI

Interactive multi-turn chat:

teamday agents chat <agent-id>

Single message execution:

teamday agents exec <agent-id> "Summarize the README in this project"

Add a Space context so the agent can access files:

teamday agents exec <agent-id> "Review the code in src/" --space <space-id>

Add Capabilities

Once your basic agent is working, extend it with Skills and MCP integrations.

Install Skills

Skills teach agents how to perform specific tasks. Add them to a Space:

teamday spaces add-skill <space-id> core:research-assistant core:data-analyst

Or install them through the web app's Space settings.

Connect MCP Servers

MCP (Model Context Protocol) servers connect agents to external tools and services:

teamday spaces add-mcp <space-id> google-search

Popular integrations include Google Analytics, Ahrefs, Slack, and GitHub. See MCP Servers for the full list.

Store Secrets

If your MCPs or skills need API keys, store them as encrypted Space secrets:

teamday spaces set-secret <space-id> OPENAI_API_KEY=sk-abc123

Set Up Authentication

For API and CLI access, you need credentials.

Option 1: OAuth Login (CLI)

teamday auth login

Opens your browser for secure authentication. Tokens are managed automatically.

Option 2: Personal Access Token (API / CI)

  1. Go to Settings in the web app
  2. Create a new Personal Access Token
  3. Copy and save it immediately (shown only once)
# Use with CLI
teamday auth set-key "td_your_token_here"

# Or as environment variable
export TEAMDAY_API_TOKEN="td_your_token_here"

See API Keys & Authentication for the full guide.

Claude API Credentials

TeamDay agents are powered by Claude. By default, the platform provides Claude API access. You can also bring your own credentials for direct billing:

# Check what's configured
teamday keys status

# Set your Claude OAuth token (from claude.ai subscription)
teamday keys set oauth sk-ant-oat01-your-token

# Or set an Anthropic API key
teamday keys set api-key sk-ant-api03-your-key

TeamDay uses a priority system: your personal credentials are used first, then organization credentials, then the platform default.

Next Steps

GuideWhat You'll Learn
Create Your First AgentIn-depth agent creation with Characters, skills, and MCPs
Spaces & WorkspacesConfigure project directories, files, and Git repos
SkillsBuild and install reusable agent capabilities
MCP ServersConnect to external tools and services
MissionsSchedule agents to run tasks automatically
CLI ToolFull command-line reference

Get Help