https://github.com/block/goose-discord
Agent Honk: A Goose discord bot that honks.
https://github.com/block/goose-discord
Last synced: 10 months ago
JSON representation
Agent Honk: A Goose discord bot that honks.
- Host: GitHub
- URL: https://github.com/block/goose-discord
- Owner: block
- License: apache-2.0
- Created: 2025-06-27T20:16:38.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-07-23T23:45:50.000Z (10 months ago)
- Last Synced: 2025-07-24T02:14:44.115Z (10 months ago)
- Language: Python
- Size: 64.5 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: CODEOWNERS
- Governance: GOVERNANCE.md
Awesome Lists containing this project
README
# Agent Honk 🦆
A Discord bot wrapper around Goose AI that brings the power of Goose to your Discord server!
# Demo videos
- Quick demo video [link](https://youtu.be/c8SPFhlZJ0o)
- Full vibecoding session (25 mins) [link](https://youtu.be/sLI7U_ayiy0)
## Features
- **Slash Command Integration**: Use `/honk` to start a new Goose session
- **Persistent Threads**: Each session runs in its own Discord thread with full context
- **Interactive Conversations**: Continue chatting in threads and Goose maintains context
- **Easy Setup**: Built with Python 3.13 and uv for modern dependency management
## Quick Start
1. **Clone and Setup**:
```bash
cd discord-goose
uv sync
```
2. **Configure Discord Bot**:
- Go to [Discord Developer Portal](https://discord.com/developers/applications)
- Create a new application and bot
- Copy the bot token
- Enable "Message Content Intent" in bot settings
3. **Environment Setup**:
```bash
cp .env.example .env
# Edit .env and add your DISCORD_TOKEN
```
4. **Run the Bot**:
```bash
uv run python -m src.agent_honk.bot
```
## Usage
1. Invite the bot to your Discord server with appropriate permissions
2. Use `/honk ` to start a new Goose session
3. Continue the conversation in the created thread
4. Goose will respond with full context awareness!
## Example
```
/honk You are a bird enthusiast. You'll answer all of my questions and also tell me fun bird facts. Start by telling me a bird fact.
```
This creates a new thread where Goose will roleplay as a bird enthusiast and provide fun facts!
## Requirements
- Python 3.13+
- uv package manager
- Discord bot token
- Goose CLI installed and accessible
## Architecture
- **bot.py**: Main Discord bot with slash commands and message handling
- **goose_client.py**: Interface to Goose CLI for running sessions
- **thread_manager.py**: Manages Discord thread state and ownership
## Future Features
- Dynamic form creation
- Scheduled polls and tasks
- Web scraping capabilities
- Multi-server session management
## Contributing
This is part of the Goose ecosystem. Feel free to contribute improvements and new features!