Forem: Farouq Aldori

Building Local AI Agents from Your Terminal with Opperator

Farouq Aldori — Fri, 07 Nov 2025 16:05:35 +0000

Hey all 👋

I’ve been working on something called Opperator, an open-source framework for building and running general-purpose AI agents locally, right from your terminal.

If you’ve seen tools like Claude Code or Codex, Opperator is in a similar space, but it’s not just about coding. It’s about automation. You can use it to create agents that organize files, generate content, process data, or monitor APIs.

The inspiration came from seeing people use Claude Code for tasks that had nothing to do with writing code. They were organizing notes, drafting documents, managing personal data, even planning events.

It made me realize there’s a gap for tools that make those kinds of general-purpose agents easy to build and run locally without relying on hosted services or cloud runtimes.

How it works

Opperator provides everything you need to create and run agents that automate your personal workflows.

It includes:

A terminal interface for interacting with your agents
A background daemon for running agents with logging, persistence, and secret management
A focused Python SDK for writing agent logic

Each agent runs as its own local process, in its own environment, and can use any model you choose, including local LLMs! 🚀

Example workflow

Opperator ships with a default "Builder" agent that helps you build agents without actually writing any code, of course you can code agents manually or with Claude Code or Codex.

Let’s say you want an agent that looks at your screenshots folder and renames files based on what’s in the image.

You can describe it in plain language:

I want to create an agent that analyzes my screenshots folder, uses AI to label and renames all files based on their content.

The Builder agent will scaffold the code, install dependencies, and let you iterate on the agent without restarting anything.

Once done, the agent will be running locally on your laptop. It just gets to work, executing the task it was designed to do. No servers, no cloud, no external dependencies.

Get started

Installation:

curl -fsSL https://opper.ai/opperator-install | bash

Launch Opperator:

op
# or the full command name
opperator

Resources:

GitHub: https://github.com/opper-ai/opperator
Docs: https://docs.opper.ai/opperator
Discord: discord.gg/wcT3bc7Y4Y

You can install it and start building right away.

I’m really curious what kinds of agents you’ll come up with — whether it’s something that organizes your files, monitors APIs, or automates your creative workflow.

If this sounds interesting, give Opperator a try and share what you build. Every bit of feedback helps shape where the project goes next.

And if you like the idea, drop a star on GitHub, it really helps others discover the project and keeps the momentum going!

New version for AiFormat - CLI tool that converts files into a format optimized for Claude

Farouq Aldori — Mon, 18 Mar 2024 11:58:03 +0000

Hey all!

Last week, I released AiFormat and the response has been great!

If you haven't used it already, it's a simple CLI tool that makes copying & pasting files into Claude a breeze.

Using it with Claude Opus has boosted my productivity significantly.

I just released a new version that I hope you will enjoy:

Added searching inside deeply nested files.
Added the ability to expand/collapse folders with the Tab key.
Added emojis to differentiate between folders (🗂️) and files (📄).
Full code re-write, including ID based navigation.

The project is fully open-source under the MIT license, contributors are more than welcome!

Here's the link to the Github repo with instructions on how to get started (it's really easy):

https://github.com/farouqaldori/aiformat/

Let me know what you think!

I created a simple CLI tool that helps you code FAST!

Farouq Aldori — Tue, 12 Mar 2024 20:53:06 +0000

Hello community!

Ever since Claude 3 released, I've been using Opus to code really fast.

Copying and pasting multiple files into the context window was the only bottleneck, so I built a handy tool that automatically converts files/folders into a format optimized for Claude, then copies them to your clipboard.

I've always wanted to build a CLI tool, and when I realized that you can build one using React with Ink, I converted my Python script into a CLI tool.

The project is fully open-source under the MIT license, contributors are more than welcome!

Here's the link to the Github repo with instructions on how to get started (it's really easy):

https://github.com/farouqaldori/aiformat/

Let me know what you think!