Fellow is a command-line AI assistant built by developers, for developers.
Unlike most AI tools that just suggest code, Fellow goes further: it executes tasks for you. It reasons step-by-step, picks commands from a plugin system, and performs actions like editing files, generating content, or writing tests — all autonomously.
Fellow was born from a simple insight: copy-pasting between ChatGPT and your editor breaks flow. What if the AI could access your codebase directly and decide what to do?
It’s a lightweight but powerful sandbox for building the tools you wish existed — and it's still evolving. If you're a developer who wants more doing and less prompting, Fellow might just be the tool you’ve been waiting for.
Full documentation for Fellow is available at: Documentation
Make sure you have Python installed on your system. Then install Fellow via pip:
pip install fellowFellow can use the OpenAI API, so you need to provide your API key. The easiest way is:
fellow add-secret OPENAI_API_KEY your_openai_api_keyThen you're ready to go. For example, to ask Fellow to write a README file:
fellow --task "write a readme file for this Python project"Fellow is built to be extensible. You can customize:
-
Commands – add your own automation logic or override existing ones. Learn more in the Custom Commands documentation
-
Clients – integrate with different AI backends like built-in OpenAI or Gemini. Or create your own client. Learn more in the Custom Clients documentation
-
Policies – control Fellow’s behavior in specific situations to ensure safe and predictable AI use. Custom Policies documentation
All notable changes to this project will be documented in this file: CHANGELOG.md
We welcome contributions! Please fork the repository and submit a pull request.
This project is licensed under the MIT License.