FAQ

FAQ

Frequently asked questions about aistack.

---

General

What is aistack?

aistack is a production-grade multi-agent orchestration framework for Claude Code with adversarial validation, persistent memory, and real-time web dashboard.

What are the main features?

• 11 specialized agent types
• 36 MCP tools
• SQLite + FTS5 + vector search
• Adversarial review loops
• Web dashboard
• 6 LLM providers

Is it free?

Yes, aistack is MIT licensed and free to use. However, you'll need API keys for LLM providers (Anthropic, OpenAI) unless you use Ollama (local).

Setup

What do I need to get started?

• Node.js 20+
• Claude Code
• API key (Anthropic, OpenAI, or Ollama)

See Installation.

How do I configure API keys?

Use environment variables:

export ANTHROPIC_API_KEY="sk-..."
export OPENAI_API_KEY="sk-..."

See Configuration Guide.

Agents

How many agents can I run simultaneously?

Default is 10, configurable via agents.maxConcurrent in config.

Can I create custom agent types?

Yes! See Custom Agent Types.

Which agent should I use?

See Agent Overview for selection guide.

Memory

Where is data stored?

SQLite database at ./data/aistack.db (configurable).

How does vector search work?

Optional semantic search using OpenAI or Ollama embeddings. See Vector Search Setup.

Can I use it without internet?

Yes, with Ollama for local LLM and local vector search.

MCP Integration

How do I connect to Claude Code?

claude mcp add aistack -- npx @blackms/aistack mcp start

See MCP Integration.

Can I use it without Claude Code?

Yes, via CLI or programmatic API. See Programmatic API.

Troubleshooting

MCP server won't start

Check configuration file exists and is valid. See Troubleshooting.

Database locked error

Close other connections or increase timeout. See Troubleshooting.

API rate limit exceeded

Reduce concurrent agents or upgrade API tier.

Advanced

Can I deploy to production?

Yes, but consider:

• API costs
• Database backups
• Security (no encryption at rest)
• Authentication setup

Can I use it with other IDEs?

Yes, via CLI or programmatic API, but MCP integration requires MCP-compatible client.

How do I contribute?

See Contributing Guide.

---

Still have questions?

• GitHub Issues
• GitHub Discussions