Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/polka-codes/polka-codes
https://github.com/polka-codes/polka-codes
ai bun coding-assistant typescript
Last synced: about 6 hours ago
JSON representation
- Host: GitHub
- URL: https://github.com/polka-codes/polka-codes
- Owner: polka-codes
- License: agpl-3.0
- Created: 2025-01-08T05:53:41.000Z (17 days ago)
- Default Branch: master
- Last Pushed: 2025-01-24T02:45:14.000Z (about 18 hours ago)
- Last Synced: 2025-01-24T03:19:18.535Z (about 17 hours ago)
- Topics: ai, bun, coding-assistant, typescript
- Language: TypeScript
- Homepage: https://polka.codes
- Size: 138 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Polka Codes - AI-Powered Coding Assistant
[](LICENSE)
[](https://bun.sh)
[](https://www.typescriptlang.org)
> **Warning**
> This project is still in very early stages of development. Please use with caution as APIs and features may change frequently.
Polka Codes is a powerful TypeScript-based AI coding assistant framework that helps developers write, improve, and maintain code through natural language interactions. It provides:
- 🚀 Core AI services with multiple provider support
- 💻 Command-line interface for local development
- 🤖 GitHub Action integration for CI/CD pipelines
- 🧩 Extensible architecture for custom integrations
## Quick Start
### Installation
```bash
# Install globally using npm
npm install -g @polka-codes/cli
# Or run directly using npx
npx @polka-codes/cli "your task description"
```
### Basic Usage
```bash
# Run some task
polka-codes "improve README.md"
# Start interactive chat session
polka-codes
# Get help
polka-codes --help
# Create config file
polka-codes config
```
For more information, see [cli README](packages/cli/README.md)
## Features
- 🤖 **Multiple AI Providers**: Supports DeepSeek (recommended), Anthropic Claude, and Ollama
- 🔧 **CLI Interface**: Interactive command-line tool with chat and task execution
- 🔄 **GitHub Action**: Seamless integration with CI/CD pipelines
- 📦 **Extensible Architecture**: Modular design for adding new AI providers and tools
- ⚡ **Type Safety**: Fully typed with TypeScript for better developer experience
- 🧪 **Testing**: Comprehensive testing with bun:test and snapshot testing
- 🔍 **Code Analysis**: Built-in tools for code understanding and improvement
## Project Structure
The project is organized as a monorepo with the following packages:
| Package | Description |
|---------|-------------|
| [core](/packages/core) | Core AI services, agent implementations, and tooling |
| [cli](/packages/cli) | Command-line interface for interacting with AI services |
| [action](/packages/action) | GitHub Action integration for CI/CD pipelines |
## Getting Started
### Prerequisites
- [Bun](https://bun.sh/) (v1.0.0 or higher)
### Development Setup
```bash
# Clone and setup
git clone https://github.com/polka-codes/polka-codes.git
cd polka-codes
bun install
# Available scripts
bun run test # Run tests across all packages
bun run check # Run type checking and linting
bun run fix # Fix linting issues
```
## License
This project is licensed under the [AGPL-3.0 License](LICENSE).
## Credits
This project is heavily inspired by the [Cline](https://github.com/cline/cline) project.
---
*Generated by polka.codes*