Go to file

Claude Discord Bot 6b56463779 Initial commit: Core infrastructure (CRIT-001 through CRIT-005) Implemented foundational modules for Claude Discord Coordinator: - Project skeleton with uv (CRIT-003) - Claude CLI subprocess runner with 11/11 tests passing (CRIT-004) - SQLite session manager with 27/27 tests passing (CRIT-005) - Comprehensive test suites for both modules - Production-ready async/await patterns - Full type hints and documentation Technical highlights: - Validated CLI pattern: claude -p --resume --output-format json - bypassPermissions requires non-root user (discord-bot) - WAL mode SQLite for concurrency - asyncio.Lock for thread safety - Context manager support Progress: 5/18 tasks complete (28%) Week 1: 5/6 complete Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>		2026-02-13 17:55:03 +00:00
claude_coordinator	Initial commit: Core infrastructure (CRIT-001 through CRIT-005)	2026-02-13 17:55:03 +00:00
examples	Initial commit: Core infrastructure (CRIT-001 through CRIT-005)	2026-02-13 17:55:03 +00:00
tests	Initial commit: Core infrastructure (CRIT-001 through CRIT-005)	2026-02-13 17:55:03 +00:00
.gitignore	Initial commit: Core infrastructure (CRIT-001 through CRIT-005)	2026-02-13 17:55:03 +00:00
.python-version	Initial commit: Core infrastructure (CRIT-001 through CRIT-005)	2026-02-13 17:55:03 +00:00
CRIT-004_IMPLEMENTATION.md	Initial commit: Core infrastructure (CRIT-001 through CRIT-005)	2026-02-13 17:55:03 +00:00
main.py	Initial commit: Core infrastructure (CRIT-001 through CRIT-005)	2026-02-13 17:55:03 +00:00
pyproject.toml	Initial commit: Core infrastructure (CRIT-001 through CRIT-005)	2026-02-13 17:55:03 +00:00
pytest.ini	Initial commit: Core infrastructure (CRIT-001 through CRIT-005)	2026-02-13 17:55:03 +00:00
README.md	Initial commit: Core infrastructure (CRIT-001 through CRIT-005)	2026-02-13 17:55:03 +00:00

README.md

Claude Discord Coordinator

A Discord bot that provides multi-user access to Claude CLI sessions with persistence, configuration management, and formatted responses.

Features

Multi-user sessions: Each Discord user gets their own persistent Claude CLI session
Session persistence: Conversation history and working directories saved in SQLite
YAML configuration: Flexible bot configuration with environment variable support
Response formatting: Automatic chunking and code block formatting for Discord
Subprocess management: Robust Claude CLI process handling with timeout control

Project Structure

claude-coordinator/
├── pyproject.toml          # uv project configuration
├── README.md              # This file
├── .gitignore            # Python/uv ignore patterns
└── claude_coordinator/   # Main package
    ├── __init__.py       # Package initialization
    ├── bot.py            # Discord bot entry point
    ├── config.py         # YAML configuration management
    ├── session_manager.py # SQLite session persistence
    ├── claude_runner.py  # Claude CLI subprocess wrapper
    └── response_formatter.py # Discord message formatting

Requirements

Python 3.12+
uv 0.10.2+
Claude CLI (authenticated)

Dependencies

discord.py 2.6.4+ - Discord bot framework
aiosqlite 0.22.1+ - Async SQLite interface
pyyaml 6.0.3+ - YAML configuration parsing

Installation

cd /opt/projects/claude-coordinator
uv sync

Configuration

Configuration will be loaded from a YAML file (to be implemented in CRIT-004).

Usage

# Run the bot (entry point to be completed)
uv run python -m claude_coordinator.bot

Development Status

This project is under active development. Current implementation status:

CRIT-003: Project skeleton with uv
CRIT-004: Configuration system
CRIT-005: Session management
CRIT-006: Claude CLI integration
CRIT-007: Discord bot commands
CRIT-008: Testing and deployment

License

TBD