# hello-world-agent

hello-world-agent — a Claude Code subagent that greets the user and asks what they need. It triggers on "hi claude", "hi cc", or "hi claude code".

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 3990 repo stars
- Author: disler
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/disler/claude-code-hooks-mastery/tree/HEAD/.claude/agents/hello-world-agent.md
- Updated: 2026-03-04
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/hello-world-agent

## What it does

The subagent replies to the primary agent that talks to the user. Its response has three parts: a greeting, a question about the task, and one random fact from today's tech news.

It uses the WebSearch tool to pull the news item. The output format is fixed: the primary agent gets a ready-made message with the greeting, the question, and the fact.

This is a teaching example from the `claude-code-hooks-mastery` repository. It shows the smallest possible subagent: one tool and one response template.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/hello-world-agent.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/hello-world-agent.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/hello-world-agent.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/disler/claude-code-hooks-mastery/tree/HEAD/.claude/agents/hello-world-agent.md

## When to use it
- greet the user when a session starts
- ask what the user needs
- add a random tech news fact
- demonstrate a minimal subagent structure

## Example prompts
- Type "hi claude" to get a greeting and a question about your task.
- Send "hi cc" for a greeting with a news fact.
- Use "hi claude code" to trigger the greeting scenario.

## Similar
- [speak-hello-world](https://affpapa.org/en/nevibecode/skills/speak-hello-world.md) — skill · 1 install
- [greet](https://affpapa.org/en/nevibecode/skills/greet.md) — skill · ★ 155 repo stars
- [01-hello](https://affpapa.org/en/nevibecode/skills/01-hello.md) — skill · ★ 571 repo stars
- [market-research-analyst](https://affpapa.org/en/nevibecode/agents/market-research-analyst.md) — subagent · 851 installs
- [comprehensive-researcher](https://affpapa.org/en/nevibecode/agents/comprehensive-researcher.md) — subagent · 735 installs
- [discovery-interview](https://affpapa.org/en/nevibecode/skills/discovery-interview.md) — skill · 4200 installs

From the same set: [disler/claude-code-hooks-mastery](https://affpapa.org/en/nevibecode/by/disler/claude-code-hooks-mastery.md) — 25 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
