# Celorga: A Portable Org-Mode Re-implementation for AI Agents

Decouple your structured note-taking workflows from Emacs with this new CLI tool.

- **Source:** [Hacker News: Show HN](https://news.ycombinator.com)
- **Published:** 2026-10-19
- **Topic:** [Software & Engineering](https://brifing.si/c/engineering)
- **Original article:** <https://github.com/aviaviavi/celorga>
- **On Brifing:** https://brifing.si/s/f67518ee-cddc-466a-aab3-3bb85e7089bf

## Emacs Dependency Reduction

After fifteen years of relying on Emacs Org mode, the developer sought a way to maintain complex note-taking workflows without remaining tethered to the Spacemacs environment. Celorga emerges as a standalone re-implementation, specifically designed to decouple structured data management from the traditional Emacs and elisp ecosystem, enabling broader accessibility across modern computing platforms.

## Core CLI Capabilities

Celorga functions as a portable command-line interface that replicates essential Org mode features. Users can perform structured editing, agenda management, and advanced searching without needing an Emacs installation. This transition allows power users to maintain their existing organizational habits while utilizing a lightweight, dependency-free tool that operates independently of heavy text-editor configurations.

## AI Agent Integration

The project introduces primitives specifically designed for AI agent interoperability. By including an MCP server, Celorga allows users to trigger agents directly from TODO items within their notes. This functionality extends beyond simple coding tasks, aiming to support general-purpose agentic workloads by providing a structured interface for task management and execution.

## Multi-Platform Availability

Celorga is currently available as a native application for macOS and iOS, with Linux and Android versions planned for future release. The tool is distributed under the Apache 2.0 license, ensuring it remains fully open-source. Developers can install the CLI directly via npm, facilitating rapid integration into existing terminal-based workflows and development environments.

## Workflow Decoupling Strategy

The shift away from Emacs reflects a broader trend where specialized text-editor workflows are being migrated to more portable, agent-compatible formats. By abstracting the Org mode logic into a CLI, Celorga enables users to keep their data portable and accessible to various AI harnesses, effectively bridging the gap between legacy note-taking and modern automation.

## General Purpose Agent Support

Unlike many existing agent harnesses that focus exclusively on software engineering, Celorga is designed for general-purpose workloads. It provides the necessary infrastructure to manage complex tasks and agent interactions within a structured document format. This approach allows users to orchestrate diverse AI-driven processes directly from their personal knowledge management systems.

## Technical Implementation Details

Built as a standalone project, Celorga avoids the overhead of elisp, making it a highly performant alternative for users who require Org-like capabilities in non-Emacs environments. The architecture prioritizes portability and ease of use, ensuring that the core primitives remain compatible with any agent or harness that supports modern structured data exchange protocols.

## Future Development Trajectory

As the project moves beyond its initial launch, the focus remains on expanding platform support and refining the agentic integration features. By providing a polished experience outside of the Emacs ecosystem, Celorga positions itself as a critical utility for professionals looking to modernize their note-taking while maintaining compatibility with their existing Org-mode data archives.

## Sources covering this story

- https://github.com/aviaviavi/celorga — 

---

_Summary written by Brifing from the original reporting. Copyright in the original article belongs to its publisher; read the full piece at the link above._