🥥 Coconut Docs

Overview

Welcome to Coconut, where everyone is a first-class citizen in the new agent-centric software development lifecycle.

Coconut is built around the following core principles:

Universal participation: Everyone can directly contribute to the project's development and evolution
Agent-centric architecture: AI agents operate at the center of the project within secure, isolated environments
Integrated project context: All context, knowledge, resources, and change proposals are stored alongside the code and managed under source control

Features & Benefits

Safe AI-powered development: Everyone can safely use language models (both code-centric and general purpose) within project context to write code, conduct research, create plans, and generate feature ideas without compromising system security
Structured project management: Provides a highly organized approach to managing context, change proposals, knowledge, and resources, keeping everything version-controlled and accessible
Intelligent agent ecosystem: Comprehensive agent management and integration capabilities, with advanced scheduling and notification features coming soon
Multi-interface access: Seamless experience across web interface, CLI, and API, ensuring you can work the way that suits you best

The `.nut` Directory

A .nut directory lives at the core of your project's source code (similar to a .git directory if you've ever explored Git's internals). Unlike Git, which focuses on version control, the .nut directory manages several complementary areas of your development workflow:

Project Context: Both project-level and technical context that helps agents understand your codebase
Knowledge & Resources: Documentation, research, and reference materials that inform development decisions
Change Proposals: Structured proposals for features, fixes, and improvements that can be reviewed and implemented

Agent Interaction Modes

Coconut provides two primary ways to interact with AI agents:

Chat-based assistants: Interactive conversations in the right-hand panel for brainstorming, planning, and general assistance
Coding assistants: Direct terminal integration for hands-on code generation, debugging, and implementation

Getting Started

Coconut offers multiple interfaces to suit different workflows and preferences: