https://github.com/niradler/chat-tools
https://github.com/niradler/chat-tools
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/niradler/chat-tools
- Owner: niradler
- Created: 2025-08-23T08:15:12.000Z (10 months ago)
- Default Branch: master
- Last Pushed: 2025-08-31T21:53:39.000Z (10 months ago)
- Last Synced: 2026-05-27T03:35:15.010Z (about 1 month ago)
- Language: TypeScript
- Size: 434 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Chat Tools Framework
A TypeScript framework for building intelligent terminal chat applications with MCP integration, tool calling, and human-in-the-loop approval systems.
## Features
- 🎨 **Modern Terminal UI** - Built with Ink (React for terminal)
- 🤖 **AI Agent Integration** - AI SDK v5 with multiple provider support
- 🔧 **MCP Protocol Support** - Connect to any MCP server
- ✋ **Smart Approval System** - Global and session-specific tool auto-approval
- 🗄️ **Session Management** - SQLite-based chat sessions and history
- 📦 **Modular Architecture** - Easy to extend and customize
## Quick Start
```bash
# Install the CLI
pnpm add -g @chat-tools/cli
# Start a basic chat
chat-tools start
# With shell extension
chat-tools start --extension shell
```
## Package Structure
- **@chat-tools/storage** - Database, sessions, auto-approval management
- **@chat-tools/tui** - Reusable terminal UI components
- **@chat-tools/agent** - AI agent, MCP, approval system
- **@chat-tools/cli** - Command-line interface
- **@chat-tools/core** - Shared types and utilities
- **@chat-tools/shell** - Shell command extension example
## Development
```bash
# Clone and setup
git clone
cd chat-tools
pnpm install
# Start development
pnpm dev
# Build all packages
pnpm build
# Run tests
pnpm test
```
## Documentation
- [Getting Started](./docs/getting-started.md)
- [Creating Extensions](./docs/extensions.md)
- [API Reference](./docs/api.md)
- [Examples](./examples/)
## License
MIT