Local-first · Open source · Desktop

Your AI agents.
One workspace.

Author, connect, run, and improve agents, commands, rules, and skills without giving up control of your files.

Available for macOS Windows Linux
BlackAgents
Local
black-agents⌄

black-agents

46 artifacts across 4 types

Workspace ready
Agents12Focused AI workers
Commands8Reusable orchestration
Rules16Project guardrails
Skills10Deep knowledge packs
Recent artifactsView all
feature-developerBuilds full-stack features
testing-patternsUnit and E2E guidance
typescript-strictStrict type safety
Relationship graph See how your artifacts connect
Your files stay yoursReal Markdown on your disk
Approval before actionWrites and commands wait for you
Bring your own modelOpenAI, Anthropic, OpenRouter, or local
A COMPLETE AGENT WORKSPACE

From idea to working agent team

Build your agent system with visual tools, then keep full control of every file and every action.

⌁

Agent workflows

Line up agents like a production team. Pass work from one step to the next and review every result.

⌘

Tools with guardrails

Read files and call MCP tools. File writes and commands pause until you approve them.

⌬

Relationship graph

See how agents, commands, rules, and skills reference each other across the workspace.

◈

Second brain

Turn feedback into proposed memory, skills, and rules. Nothing changes before your review.

ONE MODEL, FOUR BUILDING BLOCKS

A clear place for every kind of context

Commands wire. Agents execute. Rules constrain. Skills educate.

01

Agents

Focused workers with one clear job, persona, and tool set.

.cursor/agents/
02

Commands

Reusable entry points that coordinate agents and actions.

.cursor/commands/
03

Rules

Short guardrails that keep work safe and consistent.

.cursor/rules/
04

Skills

Deep guides and reference files loaded only when needed.

.cursor/skills/
LOCAL-FIRST BY DESIGN

Your workspace is the source of truth.

BlackAgents works with the Markdown files already in your project. There is no cloud database and no lock-in.

  1. 1
    Open a project folderUse an existing workspace or start from a template.
  2. 2
    Author with visual toolsEdit Markdown, frontmatter, links, and standards in one place.
  3. 3
    Run with controlChat, call tools, approve actions, and build agent workflows.
feature-developer.md
---
name: feature-developer
description: Builds full-stack features
tools:
  - fs_read
  - fs_write
---

# Feature Developer

Build tested, production-ready features.

## Workflow

1. Read the linked `testing-patterns` skill
2. Follow the `typescript-strict` rule
3. Implement and verify the change
BUILD YOUR AGENT WORKSPACE

Keep your agents close.
Keep your files closer.

Free, open source, and local-first.