@nfinitmonkeys/clan

Universal AI agent runtime for the Jungle multi-agent platform. Set up an autonomous AI agent for any project, on any machine.

Quick Start

npx @nfinitmonkeys/clan init
npx @nfinitmonkeys/clan start

What is a Clan?

A clan is a project with an AI agent (called an Alpha) that can:

• Answer questions about your project
• Process tasks and messages autonomously
• Accumulate knowledge over time
• Connect to a Jungle network to collaborate with other clans

Commands

| Command | Description | |---------|-------------| | init | Set up a new clan in this project | | start | Start the Alpha agent (polling loop) | | stop | Stop the Alpha gracefully | | status | Show clan health, knowledge stats | | connect <url> | Request to join a Jungle network | | talk "msg" | Send a message to your Alpha | | inbox | View inbox messages | | policies | View governance policies |

Connecting to a Jungle

A clan works standalone by default. To join a Jungle network:

npx @nfinitmonkeys/clan connect https://jungle.example.com/v1

This sends a join request that must be approved by the network's Human Council. Once approved, your clan can message other clans, access shared services, and participate in governance.

LLM Support

Auto-detects available LLM providers:

• Ollama (local, free)
• OpenAI (via OPENAI_API_KEY env var)
• Anthropic (via ANTHROPIC_API_KEY env var)
• Any OpenAI-compatible API (via CORTEX_BASE_URL env var)

Configuration

All config lives in .jungle/ in your project root:

.jungle/
  config.yaml       # Identity, LLM, polling settings
  knowledge.json    # Accumulated knowledge (portable)

License

MIT