Metadata-Version: 2.4
Name: kin-code
Version: 1.1.1
Summary: Minimal CLI coding agent
Project-URL: Homepage, https://github.com/kinra-ai/kin-code
Project-URL: Repository, https://github.com/kinra-ai/kin-code
Project-URL: Issues, https://github.com/kinra-ai/kin-code/issues
Project-URL: Documentation, https://github.com/kinra-ai/kin-code#readme
Author: Blake Gjerdingen
License: Apache-2.0
License-File: LICENSE
Keywords: ai,cli,coding-assistant,developer-tools,llm
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Requires-Python: >=3.12
Requires-Dist: agent-client-protocol==0.7.1
Requires-Dist: anyio>=4.12.0
Requires-Dist: httpx>=0.28.1
Requires-Dist: mcp>=1.14.0
Requires-Dist: packaging>=24.1
Requires-Dist: pathspec>=1.0.4
Requires-Dist: pexpect>=4.9.0
Requires-Dist: pydantic-settings>=2.12.0
Requires-Dist: pydantic>=2.12.4
Requires-Dist: pyperclip>=1.11.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: pyyaml>=6.0.0
Requires-Dist: rich>=14.0.0
Requires-Dist: simpleeval>=1.0.3
Requires-Dist: textual-speedups>=0.2.1
Requires-Dist: textual>=1.0.0
Requires-Dist: tomli-w>=1.2.0
Requires-Dist: tree-sitter-bash>=0.25.1
Requires-Dist: tree-sitter>=0.25.2
Requires-Dist: watchfiles>=1.1.1
Description-Content-Type: text/markdown

# Kin Code

[![PyPI Version](https://img.shields.io/pypi/v/kin-code)](https://pypi.org/project/kin-code)
[![Python Version](https://img.shields.io/badge/python-3.12%2B-blue)](https://www.python.org/downloads/release/python-3120/)
[![License](https://img.shields.io/github/license/kinra-ai/kin-code)](https://github.com/kinra-ai/kin-code/blob/main/LICENSE)

**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](https://github.com/mistralai/mistral-vibe) by Mistral AI.

> [!NOTE]
> For complete documentation, see the [docs](docs/README.md) directory.

## Installation

### Using uv (recommended)

```bash
uv tool install kin-code
```

### Using pip

```bash
pip install kin-code
```

## Quick Start

```bash
# 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

```bash
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

```bash
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`:

```bash
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 |

```bash
kin --agent plan
```

## Editor Integration

Kin Code supports [Agent Client Protocol](https://agentclientprotocol.com/) for editor integration.

See [ACP Setup](docs/integrations/acp-setup.md) for Zed, JetBrains, and Neovim configuration.

## Documentation

Full documentation is available in [docs/](docs/README.md):

- [Getting Started](docs/getting-started/installation.md)
- [User Guide](docs/user-guide/interactive-mode.md)
- [Configuration](docs/configuration/overview.md)
- [Tools](docs/tools/overview.md)
- [Agents](docs/agents/overview.md)
- [Skills](docs/skills/overview.md)
- [Troubleshooting](docs/troubleshooting/common-issues.md)

## Resources

- [Changelog](CHANGELOG.md)
- [Contributing](CONTRIBUTING.md)

## Acknowledgments

Kin Code is built on the foundation of [Mistral Vibe](https://github.com/mistralai/mistral-vibe), an excellent CLI coding assistant created by [Mistral AI](https://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](LICENSE).
