Kin Code

An AI-powered CLI coding assistant.

Kin Code provides a conversational interface to your codebase, allowing you to explore, modify, and interact with projects using natural language and a powerful set of tools.

Based on Mistral Vibe by Mistral AI.

Note

For complete documentation, see the docs directory.

Installation

Using uv (recommended)

uv tool install kin-code

Using pip

pip install kin-code

Quick Start

# Navigate to your project
cd /path/to/project

# Run Kin Code
kin

# Or with an initial prompt
kin "Explain this codebase"

On first run, Kin Code will prompt you to configure your API key.

Features

• Interactive Chat - Conversational AI that understands your codebase
• Powerful Tools - Read, write, search, and execute commands
• Project Awareness - Automatic context from file structure and git
• Multiple Agents - Different profiles for different workflows
• Skills System - Extend functionality with reusable components
• MCP Support - Integrate external tools via Model Context Protocol

Usage

Interactive Mode

kin                          # Start interactive session
kin "your prompt"            # Start with a prompt
kin --agent plan             # Use read-only agent
kin --continue               # Continue last session

Programmatic Mode

kin --prompt "Analyze code" --max-turns 5 --output json

Key Shortcuts

Shortcut	Action
Enter	Send message
Ctrl+J	New line
Ctrl+C	Interrupt
Ctrl+O	Toggle tool output
Shift+Tab	Toggle auto-approve

File References

Reference files with @:

> Explain what @src/main.py does

Configuration

Configuration is stored in ~/.kin-code/:

~/.kin-code/
  config.toml      # Main configuration
  .env             # API keys
  agents/          # Custom agents
  prompts/         # Custom prompts
  skills/          # Global skills

API Keys

Configure via kin --setup or add to ~/.kin-code/.env:

OPENAI_API_KEY=sk-...

Built-in Agents

Agent	Description
default	Standard agent, asks for approval
plan	Read-only, auto-approves safe tools
accept-edits	Auto-approves file edits
auto-approve	Auto-approves everything

kin --agent plan

Editor Integration

Kin Code supports Agent Client Protocol for editor integration.

See ACP Setup for Zed, JetBrains, and Neovim configuration.

Documentation

Full documentation is available in docs/:

• Getting Started
• User Guide
• Configuration
• Tools
• Agents
• Skills
• Troubleshooting

Resources

• Changelog
• Contributing

Acknowledgments

Kin Code is built on the foundation of Mistral Vibe, an excellent CLI coding assistant created by Mistral AI. We're grateful for their work in open-sourcing the project under the Apache 2.0 license.

License

Apache License 2.0. See LICENSE.