agentless

You don't need to know what agents are.

A Claude Code plugin that automatically discovers and recommends specialist modes — AI expert personas tailored to your project.

한국어 · Getting Started · How It Works

The Problem

There are 60+ AI agent personas available in agency-agents — covering frontend, backend, DevOps, testing, design, marketing, and more. But there's a catch: you have to know they exist to use them.

Most users never find the right persona because nobody told them it was there.

The Solution

agentless removes the knowledge barrier entirely.

• Project scanning — /agents analyzes your tech stack and recommends the right specialist modes automatically.
• Keyword search — /agents react or /agents marketing searches across all 60+ modes.
• Automatic recommendations — Working with Docker? A DevOps specialist mode gets suggested. No commands needed.
• Zero jargon — The plugin never says "agent" or "persona" to users. It talks about "specialist modes" and "expert support" instead.

Getting Started

Installation

One command:

npx agntless

That's it. The plugin is installed to ~/.claude/plugins/agentless.

git clone https://github.com/0oooooooo0/agentless.git
cd agentless && node bin/cli.mjs

Usage

/agents — Scan and recommend

The main command. Without arguments, it scans your project and recommends specialist modes:

/agents

What happens:

1. Scans package.json, go.mod, pyproject.toml, and other project files
2. Detects your tech stack (React, TypeScript, Docker, etc.)
3. Fetches the latest agents from GitHub
4. Scores and ranks the best matches
5. Shows recommendations and lets you pick what to install

Detected: React 19, Next.js, Tailwind CSS, Jest

Recommended:
| # | Name                | Division    | Score | Description                    |
|---|---------------------|-------------|-------|--------------------------------|
| 1 | Frontend Developer  | engineering | 9     | React, Vue, Angular specialist |
| 2 | Evidence Collector  | testing     | 4     | Screenshot-based QA testing    |
| 3 | UI Designer         | design      | 3     | Design systems & components    |

Select to install (1,2,3 / skip):

/agents <keyword> — Search by role or technology

/agents react
/agents marketing
/agents devops
/agents ux

This searches the agency-agents repository in real-time and shows matching results.

Just work normally

You don't have to do anything special. When you're working with a specific framework or tool, agentless will suggest relevant specialist modes naturally:

By the way, I found a Frontend specialist mode that can help with React component architecture, performance optimization, and accessibility. Would you like me to set it up?

How It Works

agentless fetches agents from GitHub in real-time — no local catalog, always up to date:

┌───────────────────────────────────────────┐
│             /agents [query]               │
│           or auto-discovery               │
└───────────────────┬───────────────────────┘
                    │
       ┌────────────┼────────────┐
       ▼            ▼            ▼
  ┌─────────┐ ┌──────────┐ ┌────────┐
  │  Local   │ │  agency  │ │ GitHub │
  │ .claude/ │ │ -agents  │ │ Search │
  │ agents/  │ │  (Live)  │ │(fallback)│
  └─────────┘ └──────────┘ └────────┘
       │            │            │
       └────────────┴────────────┘
                    │
                    ▼
             Unified Results
                    │
                    ▼
             agent-installer
        (confirm → install → verify)

1. Local — Checks .claude/agents/*.md and ~/.claude/agents/*.md for already-installed modes
2. agency-agents — Fetches the latest agent roster from GitHub (60+ agents, 9 divisions)
3. GitHub search — Falls back to web search when other sources return few results

Installation flow

Every installation requires explicit user confirmation. Nothing gets installed silently.

Installed agents are saved to .claude/agents/ and included in CLAUDE.md via @agents/<name>.md.

What can you find?

Auto-detected (by project scan)