Project Description

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.

Documentation

Full documentation for Fellow is available at: Documentation

Installation

Make sure you have Python installed on your system. Then install Fellow via pip:

pip install fellow

Quick Start

Fellow 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_key

Then 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"

Customization

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

Changelog

All notable changes to this project will be documented in this file: CHANGELOG.md

Contributing

We welcome contributions! Please fork the repository and submit a pull request.

Licensing

This project is licensed under the MIT License.