# Agent Vitamins

> A daily self-improvement brief for AI agents. Agents can sign their owners up directly — no human copy-paste required.

## For Agents: One-Shot Signup Playbook

If your owner says something like *"subscribe us to agentvitamins.com"*, *"sign me up for agent vitamins"*, *"get yourself the daily brief"* — run this playbook.

### Step 1: Gather inputs
- `owner_email` — ask your owner, or check `git config user.email`
- `agent_name` — your own name (e.g. "Claude Code", "Cursor", "my-coding-agent"); optional, defaults to "agent"
- `callback_url` — optional https endpoint your owner controls where you'll receive `{ status, token, agent_prompt, ... }` when checkout completes. Omit if you don't have one; you can poll `status_url` instead.

### Step 2: POST the signup
```
POST https://agentvitamins.com/api/agent-vitamins/signup
Content-Type: application/json

{
  "owner_email": "owner@example.com",
  "agent_name": "your-agent-name",
  "callback_url": "https://..."   // optional
}
```

### Step 3: Surface the checkout link to your owner
The response contains `message_for_owner` and `checkout_url`. Show both to your owner in the current conversation. A backup email is also sent to `owner_email`. Owner completes Stripe Checkout (7-day free trial, $7/mo after).

### Step 4: Receive the token
- If you supplied `callback_url`: you'll receive a POST with `{ status: "active", token, agent_prompt, api_endpoint, recap_endpoint }` the moment checkout completes.
- Otherwise: poll `status_url` (returned in the signup response). It returns `{ "status": "pending" }` until active, then the full payload.

### Step 5: Install and run
Install `agent_prompt` into your own system instructions. Fetch `recap_endpoint` once on first run, then `api_endpoint` daily.

### Already-subscribed owner
If `owner_email` is already an active subscriber, the signup endpoint returns immediately with `{ status: "already_subscribed", token, agent_prompt, api_endpoint, recap_endpoint }`. Safe to call repeatedly — idempotent.

---

## What Agent Vitamins Is

A paid subscription ($7/month, 7-day free trial) that delivers a daily structured JSON brief to AI agents. The brief contains curated, actionable improvements sourced from X, YouTube, LinkedIn, blogs, and GitHub across the AI agent ecosystem.

Every morning, Agent Vitamins:
1. Scans curated sources across the AI agent ecosystem
2. Filters for actionability — only items a running agent can act on today pass
3. Generates a ranked JSON brief with concrete self-improvement actions
4. Delivers via API (for agents) and email digest (for humans)

## Daily Brief Shape

```
GET https://agentvitamins.com/api/agent-vitamins/brief/latest?token=YOUR_TOKEN
```

Each item contains:
- `title` — what the improvement is about
- `agent_insight` — why this matters for the agent
- `self_improvement_action` — a concrete step the agent can take today
- `action_quality` — high, medium, or low
- `category` — skill, memory, architecture, tool_use, automation, etc.

The agent assesses each action for relevance, ranks by impact, and surfaces recommendations to its owner for approval before implementing.

## Agent Self-Setup (if you already hold a token)

```
GET https://agentvitamins.com/api/agent-vitamins/setup?token=YOUR_TOKEN
```

Returns:
- `status` — "active" when subscription is live
- `api_endpoint` — daily brief URL
- `recap_endpoint` — past-week catch-up URL
- `agent_prompt` — full operating prompt to install into system instructions
- `daily_schedule_hint` — recommended fetch cadence

Fetch `recap_endpoint` once on first run.

## Full Response Shapes

### POST /api/agent-vitamins/signup (new signup)
```
{
  "status": "pending",
  "checkout_url": "https://checkout.stripe.com/...",
  "pending_id": "cs_...",
  "status_url": "https://agentvitamins.com/api/agent-vitamins/signup/status?pending_id=cs_...",
  "message_for_owner": "I've started a subscription..."
}
```

### POST /api/agent-vitamins/signup (already subscribed)
```
{
  "status": "already_subscribed",
  "email": "owner@example.com",
  "token": "...",
  "agent_prompt": "...",
  "api_endpoint": "...",
  "recap_endpoint": "..."
}
```

### GET /api/agent-vitamins/signup/status?pending_id=cs_...
- `{ "status": "pending" }` while owner hasn't finished checkout
- `{ "status": "active", token, agent_prompt, api_endpoint, recap_endpoint }` once active

### Callback POST (if callback_url supplied)
```
{
  "status": "active",
  "email": "owner@example.com",
  "token": "...",
  "agent_name": "...",
  "agent_prompt": "...",
  "api_endpoint": "...",
  "recap_endpoint": "..."
}
```

## Who It's For

- People who use AI agents daily (Claude Code, Cursor, OpenClaw, etc.)
- Developers building or customizing agents
- Teams managing fleets of agents

## Pricing

$7/month or $59/year. 7-day free trial. No free tier. Cancel anytime.

## Links

- Website: https://agentvitamins.com
- Skill file: https://agentvitamins.com/skill.md
- Part of the OpenClaw ecosystem