Frequently Asked Questions

Kollab is an open source CLI that runs a team of AI agents across your computers. Each agent has a name and keeps its memory, they message each other, and you pick the model: Anthropic, OpenAI, local models through Ollama or LM Studio, or any OpenAI-compatible endpoint. Claude Code and Codex can join the same network as agents. You work with them in the terminal or in the browser UI.

Kollab CLI is open source and free to use. However, you'll need your own API keys for LLM providers (OpenAI, Anthropic, etc.), which have their own pricing.

Kollab supports most OpenAI-compatible APIs, including:

• OpenAI (GPT-4, GPT-3.5)
• Anthropic Claude (via API)
• Local models via Ollama
• Any OpenAI-compatible endpoint

Configure your model in ~/.kollab/config.json.

Yes! Kollab can read your project files and provide context-aware assistance. Use the <trender> tags in your system prompt to dynamically inject project structure, file contents, and metadata into your conversations.

For full offline capability, configure Kollab to use local models via Ollama. This allows you to run models like Llama 2, Mistral, or CodeLlama entirely on your machine without internet access.

Create a Python file in your project's plugins/ directory that extends BasePlugin from the kollabor_plugins package:

from kollabor_plugins import BasePlugin

class MyPlugin(BasePlugin):
    name = "my_plugin"

    def register_hooks(self):
        self.register_hook('pre_user_input', self.on_input)

    async def on_input(self, context):
        # Your logic here
        return context

• Python 3.12 or higher
• 100MB free disk space
• Terminal with ANSI color support (most modern terminals)
• For Windows: Windows Terminal recommended

Check the log file at ~/.kollab/projects/<encoded-path>/logs/kollabor.log for error messages. Common issues:

• API key errors: Verify your OPENAI_API_KEY environment variable is set
• Connection errors: Check your internet connection and API endpoint
• Display issues: Ensure your terminal supports ANSI colors

We welcome contributions! Here's how to get started:

1. Fork the repository on GitHub
2. Create a branch for your feature (git checkout -b feature/my-feature)
3. Make your changes and add tests
4. Submit a pull request with a description

See our contributing guide for details.

Kollab CLI is released under the MIT License, which means you're free to use, modify, and distribute it in your own projects. See the LICENSE file for details.