https://github.com/lockwo/claire
Claire makes slack your IDE
https://github.com/lockwo/claire
ai-agents automation chatgpt claude-code code-generation slack-bot
Last synced: 19 days ago
JSON representation
Claire makes slack your IDE
- Host: GitHub
- URL: https://github.com/lockwo/claire
- Owner: lockwo
- License: apache-2.0
- Created: 2026-01-19T23:30:47.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-01-20T23:33:54.000Z (30 days ago)
- Last Synced: 2026-01-21T09:39:34.791Z (29 days ago)
- Topics: ai-agents, automation, chatgpt, claude-code, code-generation, slack-bot
- Language: TypeScript
- Homepage: https://lockwo.github.io/claire/
- Size: 216 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Claire
Slack-native AI code agent. Mention `@claire` in any thread to read/write code, run commands, and push to GitHub.
> **CAUTION**: This codebase is mostly AI-generated [OpenCode](https://github.com/anomalyco/opencode). Additionally, Claire executes arbitrary AI-generated code on your system. Running an AI agent with shell access, file system permissions, and GitHub credentials carries inherent security risks. Use at your own risk and only in sandboxed/isolated environments.
## Features
- **Thread = session**: Each Slack thread is a coding session with full context
- **GitHub integration**: Clone, branch, commit, push, create PRs
- **File tools**: Read, write, edit, glob, grep, bash
- **Attachments**: Auto-extracts text from PDFs and LaTeX
- **Artifacts**: Uploads generated images and files back to Slack
## Quick Start
```bash
git clone https://github.com/lockwo/claire.git
cd claire
bun install
cp .env.example .env
# Edit .env with your tokens (see docs/SLACK_SETUP.md)
bun run dev
```
In Slack:
```
/invite @Claire
@Claire hello
```
## Documentation
- [Slack Setup](docs/SLACK_SETUP.md) - Create the Slack app
- [Configuration](docs/CONFIGURATION.md) - Environment variables
- [Deployment](docs/DEPLOYMENT.md) - Docker and production
- [Troubleshooting](docs/TROUBLESHOOTING.md) - Common issues
- [Google Meet Integration](docs/MEET_INTEGRATION.md) - Voice-triggered coding from meetings
## Usage
```
@claire
```
### Controls
Include in your message:
| Control | Description |
|---------|-------------|
| `repo=owner/repo` | Set GitHub repository |
| `branch=name` | Set/create branch |
| `model=gpt-5.2` | Use specific model |
| `mode=chat` | Read-only mode (no writes) |
| `scope=channel` | Read channel history (not just thread) |
| `reasoning=none\|low\|medium\|high\|xhigh\|auto` | Set reasoning effort |
| `verbosity=low\|medium\|high` | Control output length |
| `websearch=on\|off` | Toggle web search |
| `ultrathink` | Shortcut for maximum reasoning (xhigh) |
| `abort` | Cancel current task and clear queue |
| `save` / `load=session-id` | Persist/restore sessions |
| `help` | Show commands |
Examples:
```
@claire repo=acme/api branch=fix/auth fix the JWT expiration bug
@claire scope=channel summarize this channel
```
## Environment
Required in `.env`:
```bash
SLACK_BOT_TOKEN=xoxb-...
SLACK_APP_TOKEN=xapp-...
ANTHROPIC_API_KEY=sk-ant-...
GITHUB_TOKEN=ghp_... # optional
```
## Development
```bash
bun run dev # Hot reload
bun run typecheck # Type check
bun test # Run tests
```