agent-brain-start

Agent Brain Start

Purpose

Starts the Agent Brain server for the current project. The server provides:

• Document indexing and storage
• Hybrid, semantic, and keyword search
• Multi-instance support with automatic port allocation

Usage

/agent-brain:agent-brain-start [--path <dir>] [--host <host>] [--port <port>] [--foreground] [--strict] [--json]

Parameters

Parameter	Required	Default	Description
--path, -p	No	auto-detect	Project path
--host	No	127.0.0.1	Server bind host (overrides config)
--port	No	auto-select (8000-8100)	Server port (overrides config)
--foreground, -f	No	false	Run in foreground (don't daemonize)
--timeout	No	30	Startup timeout in seconds
--strict	No	false	Fail on critical provider config errors
--json	No	false	Output as JSON

Execution

Pre-flight Check

Verify the project is initialized:

# Check for .agent-brain/ directory
ls -la .agent-brain/

If not initialized:

agent-brain init

Start Server

# Start in background (default, recommended)
agent-brain start

# Start on a specific port
agent-brain start --port 8080

# Start in foreground for debugging
agent-brain start --foreground

# Start with strict mode (fail on missing API keys)
agent-brain start --strict

# Start for a specific project path
agent-brain start --path /my/project

# JSON output for scripting
agent-brain start --json

Verify Server Started

agent-brain status

Output

Successful Start

Agent Brain Server Running
URL: http://127.0.0.1:8000
PID: 12345
Project: /home/user/my-project
Log: /home/user/my-project/.agent-brain/logs/server.log

Next steps:
  - Query: agent-brain query 'search term' --url http://127.0.0.1:8000
  - Stop: agent-brain stop

JSON Output

{
  "status": "started",
  "base_url": "http://127.0.0.1:8000",
  "pid": 12345,
  "project_root": "/home/user/my-project",
  "log_file": "/home/user/my-project/.agent-brain/logs/server.log"
}