xatuke/wrapper

wrapper is a command line tool for running AI agents on Slack, where each agent lives inside its own isolated container and every conversation is traced for cost, tokens, and tool usage using an open source tracing tool called Langfuse. The project treats an agent as nothing more than configuration plus tools, so adding a new agent means writing a small YAML file and optionally a folder of custom tool code, rather than building a new service from scratch. Each agent gets its own Slack app that connects over an outbound only connection, meaning nothing needs to be exposed to the public internet, along with its own storage for conversation history and per message traces. Optional features let an agent schedule its own recurring tasks, keep persistent memory between conversations, and work with files in its own workspace. Custom Docker images can add extra command line tools or packages, and longer secrets can be stored safely in an encoded form. Getting started involves installing dependencies, copying an example configuration file, running an init command that starts the tracing stack and sets up the organization, adding an API key, then creating and starting an agent with a couple of commands before inviting it into a Slack channel. From there, a small set of day to day commands cover checking status, viewing logs, updating environment variables, restarting, and removing an agent. The tool supports two ways of running: locally with Docker Compose on your own machine or a cloud server, or on Kubernetes for AWS or Google Cloud, using the exact same commands either way. Files that Kubernetes or Docker Compose need are generated automatically by the tool and are not meant to be edited directly, while each user's own agent configurations live in their own separate, git ignored folder so updates to the framework do not touch a user's custom agents.