AgentMicro Product Information

AgentMicro is a Codex task monitor for macOS that functions as a local-first companion for Codex. It tracks parallel Codex tasks, projects, and results from the macOS menu bar, allowing for the monitoring of background operations without reopening the main interface. The application is compatible with both Codex Desktop and the Codex CLI.

Real-Time Task Monitoring

As a macOS menu bar companion, the tool facilitates parallel task tracking by listing active projects in a dropdown queue. Working tasks remain at the top of the list to indicate current activity. Each entry displays specific metadata, including the project name, current-turn duration, and a fast-mode marker. This interface provides visibility into multiple background processes simultaneously.

Status Indicator Definitions

The software utilizes a Codex status indicator system featuring six status lights to represent five distinct states. These indicators categorize the condition of background tasks to identify which sessions require attention. The states identified by the tool include:

Thinking Unread result Needs input Error Idle

Privacy and Local Metadata Security

AgentMicro is a local-first task monitor that reads local session metadata. It does not upload prompts, code, responses, or task history to external servers, and the application operates without a cloud service or user account. The base mode does not require Accessibility permissions. An optional enhanced detection mode can be enabled to read visible local labels, though it does not perform automated actions such as clicking or typing.

One-Click Workflow Integration and Requirements

The application integrates with the Codex Desktop environment, allowing users to open a matching conversation by selecting a task from the menu. System requirements include macOS 14 or later. AgentMicro is an open source Codex companion for Mac that is community-maintained and independent of OpenAI or CodexBar.

faq

Does this Codex task monitor for macOS require an account?

No. The application is a local utility that does not require an account to function. It tracks tasks by reading metadata stored on the local machine.

How are parallel tasks organized in the menu bar?

The interface organizes tasks in a dropdown list, placing active sessions at the top of the queue. Each row displays the project name and the duration of the current turn to provide information regarding active sessions.

Is AgentMicro compatible with the Codex CLI?

Yes. The software is compatible with both the Codex Desktop application and the Codex CLI. It monitors session metadata to provide a unified status view regardless of which interface initiated the task.