Skip to content

Repository files navigation

Sidekick

Sidekick, Junior Sidekick.

Kotlin License

Sidekick is a Slack-based AI assistant for AI-pilled teams. It listens in Slack, runs an LLM-powered agent, and replies in DMs, channels, and threads.

Overview

Sidekick is built for teams that want an assistant where the work already happens: Slack.

According to GPT-5.5 summary, it receives Slack events, resolves user identity, persists conversation history, runs a Koog agent through OpenRouter, and posts the response back to the right Slack conversation. Eventually, Anton will re-write it to not be a hallucination. This day hasn't come yet, because Sidekick is not fully alive yet.

Key Features

  • Slack-native interaction through app mentions, DMs, channel messages, and Slack assistant chat.
  • Thread-aware replies for channel conversations.
  • Koog-based agent runtime using OpenRouter as the LLM gateway.
  • File-based workspace operations for reading, searching, and editing project files.
  • Git tools for cloning, pulling, and pushing private GitHub and Bitbucket repositories.
  • Sandboxed bash execution for running workspace commands with configurable network access.

Configuration

Configure the Slack Events API request URL to point at Sidekick's endpoint:

/slack/events

Recommended bot event subscriptions:

app_mention
message.channels
message.groups
message.im
message.mpim

Recommended bot token scopes for development:

app_mentions:read
chat:write
channels:history
channels:read
groups:history
groups:read
im:history
im:read
im:write
mpim:history
mpim:read
users:read

Additional bot token scopes required by optional Slack agent tools:

Scope Tools that need it
canvases:read slackCanvasCreate
canvases:write slackCanvasCreate
files:read slackCanvasCreate, slackFileDownload
files:write attachFile
reactions:write slackReactionAdd
users:read:email slackUserSearch

Integrations

Integration Purpose
Dumphere Publishes internal HTML and Markdown files and returns share URLs.

Ingredients

Status

Sidekick is a research preview, not a polished product. The core Slack-to-agent loop works, but the project is actively exploring what a Slack-native AI teammate can do for a team. Expect sharp edges and frequent changes while the shape of the product is still being discovered.

License

Sidekick is licensed under the Apache License 2.0.

About

No description, website, or topics provided.

Resources

Stars

11 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages