koan Skill
koan is a Python AI agent skill for Codex, ChatGPT with npx, docker, git clone. Autonomous background agent that consumes unused Claude Max quota to explore, audit, and improve a codebase — communicating with its human via Telegram and a shared mission queue.
How to use koan Skill
Install or run
git clone https://github.com/Anantys-oss/koan.git && cd koan
cp -r instance.example instance && cp env.example .env # then fill in messaging + auth creds
./setup-docker.sh # detect host paths, generate mounts
make docker-pull-up # pull & run prebuilt image (or: make docker-up to build from source)
make docker-logs # watch it workCompatible clients
What is koan Skill?
koan is a Python AI agent skill for Codex, ChatGPT with npx, docker, git clone. Autonomous background agent that consumes unused Claude Max quota to explore, audit, and improve a codebase — communicating with its human via Telegram and a shared mission queue. This profile combines repository metadata with install, compatibility, and usage signals so developers can quickly decide whether it fits their agent workflow before opening the source repository.
Automated repository signals based on public metadata such as recency, license, installation evidence, and adoption. These are not a security audit or endorsement.
Key capabilities
- Reusable instructions support
- Includes SKILL.md support
- Shell commands support
- Browser use support
- Document generation support
- OpenAI provider support
- Anthropic provider support
Available tools
Technical details
Install or run koan using npx. Check Anantys-oss/koan for the latest setup command.
- Built for Python
- Built for Node.js
- Built for Docker
- Built for Go
- Built for Rust
- Install or run with npx
- Install or run with docker
- Install or run with git clone
Requirements and access
Security and permissions
Review permissions before connecting any MCP server to an agent. Pay special attention to whether it can read local files, write data, call external services, or perform destructive actions.
When to use koan Skill
- Use it for reusing agent instructions, scripts, and references.
- Use it for agent skills workflows.
- Use it for coding workflows.
- Use it for data workflows.
- Use it for codex users.
Built with
Explore related resources
Frequently asked questions
What is koan?
koan is a Python AI agent skill for Codex, ChatGPT with npx, docker, git clone. Autonomous background agent that consumes unused Claude Max quota to explore, audit, and improve a codebase — communicating with its human via Telegram and a shared mission queue.
Who is koan best for?
koan is best for reusing agent instructions, scripts, and references, agent skills workflows, coding workflows, data workflows, codex users.
How do I install koan?
Install or run koan using npx. Check koan for the latest setup command.
Is koan actively maintained?
koan may need a closer maintenance check before production use.
