|
1 | 1 | # Coding Agent for Slack |
2 | 2 |
|
3 | | -A sample Slack **coding agent** built with [Bolt for Python](https://docs.slack.dev/tools/bolt-python/). Mention it in a channel with a task and a repo, and it decides whether to answer in place or create a dedicated **code channel** for the work. In a code channel it clones the repo into a temp workspace, makes changes with your approval, and keeps the channel's plan, context bar, and code tab current as it goes. |
| 3 | +A sample Slack agent that showcases [Slack Code](https://docs.slack.dev/ai/slack-code/) built with [Bolt for Python](https://docs.slack.dev/tools/bolt-python/). Mention it in a channel with a task and a repo, and it decides whether to answer in place or create a dedicated **code channel** for the work. In a code channel it clones the repo into a temp workspace, makes changes with your approval, and keeps the channel's plan, context bar, and code tab current as it goes. |
4 | 4 |
|
5 | 5 | > [!WARNING] |
6 | 6 | > **This agent runs commands generated by a language model on the machine running the app.** Only run it against trusted, throwaway repositories, on a machine you're comfortable letting it operate. Refer to the framework README for how command approvals work. |
7 | 7 |
|
8 | 8 | ## Choose your framework |
9 | 9 |
|
10 | | -| App | Directory | Get started | Framework | |
11 | | -|-----|-----------|-------------|-----------| |
| 10 | +| App | Directory | Get started | Framework | |
| 11 | +| --------------------- | -------------------- | -------------------------------------------- | --------------------------------------------------------------- | |
12 | 12 | | **OpenAI Agents SDK** | `openai-agents-sdk/` | [View README](./openai-agents-sdk/README.md) | [openai-agents](https://openai.github.io/openai-agents-python/) | |
13 | 13 |
|
14 | 14 | ## What it can do |
15 | 15 |
|
16 | | -* **Channel @mentions and direct messages** — Mention the agent with a task, or message it directly. Quick questions get an answer in place; work that takes more than one message gets a code channel linked back to your message, along with the conversation it came from. |
17 | | -* **Code channels** — Keep chatting in the channel without an @mention. The agent writes its plan to a Plan tab you can comment on, publishes its changes to the code tab, and pins the repo, branch, and CI status to the context bar. |
18 | | -* **Command approvals** — File edits, read-only commands, and local git changes run right away. Anything else, like running tests, posts Approve and Deny buttons and waits for your decision. |
19 | | -* **Slash commands** — The agent registers commands like `/run-tests` for each channel and decides what each one does. |
20 | | -* **Wrap up** — When you say the work is done, the agent posts a summary back to your original message and archives the channel. |
21 | | -* **App Home** — The Home tab explains how to start a task. |
| 16 | +- **Channel @mentions and direct messages** — Mention the agent with a task, or message it directly. Quick questions get an answer in place; work that takes more than one message gets a code channel linked back to your message, along with the conversation it came from. |
| 17 | +- **Code channels** — Keep chatting in the channel without an @mention. The agent writes its plan to a Plan tab you can comment on, publishes its changes to the code tab, and pins the repo, branch, and CI status to the context bar. |
| 18 | +- **Command approvals** — File edits, read-only commands, and local git changes run right away. Anything else, like running tests, posts Approve and Deny buttons and waits for your decision. |
| 19 | +- **Slash commands** — The agent registers commands like `/run-tests` for each channel and decides what each one does. |
| 20 | +- **Wrap up** — When you say the work is done, the agent posts a summary back to your original message and archives the channel. |
| 21 | +- **App Home** — The Home tab explains how to start a task. |
22 | 22 |
|
23 | 23 | For full setup instructions, pick a framework above and follow the README in that directory. |
0 commit comments