agx is an open-source coding agent harness and developer orchestration tool developed by ramarlina. It serves as a unified orchestration layer to coordinate tasks, repository context, and AI-driven workflows across command-line and desktop environments. Operating both as a background daemon and interactive CLI (with an accompanying desktop interface), agx coordinates local repository workspaces with external developer platforms. It manages multi-project contexts using a local SQLite persistence layer and handles integrations like GitHub pull request tracking, review interfaces, and task resolution from issue trackers like Linear. Unlike simple single-prompt wrapper scripts, agx is architected around structured workspace state, polymorphic link stores, and tracker resolvers. It decouples task management and PR review synchronizations from raw model interactions, allowing developers to import/export YAML workspace definitions and manage project environments consistently. agx is maintained as an open-source project on GitHub under active development, offering cross-platform CLI tools alongside notarized macOS desktop releases.
Tags: agent harness, ai agent, cli, coding agent, developer tools, OpenSource
/prs review interfaces for managing code reviews. - Issue Tracker Resolvers — Context-aware integration with issue tracking platforms such as Linear and local task identifiers. - Daemon & CLI Modes — Background daemon support alongside standard CLI execution for continuous sync and workflow automation. - Local SQLite Store — Local schema-backed storage for per-project authentication tokens, repository states, and metadata. - Desktop Companion — Packaged desktop application option alongside the core terminal tooling for macOS environments.agx is designed for software engineers and technical leads who need an orchestrator to bridge local coding agents with GitHub workflows and issue trackers like Linear. It is well-suited for developers wanting structured workspace and PR automation rather than a standalone chat-only terminal assistant.
bash git clone https://github.com/ramarlina/agx.git cd agx npm install npm run build npm link (Note: Pre-built macOS desktop binaries are also available from the GitHub Releases page.)bash # Initialize or start the background daemon agx daemon start # Configure repository context and tokens agx config set-token github <YOUR_GITHUB_TOKEN>bash # Import a workspace definition agx workspace import ./workspace.yaml # Launch the interactive PR review interface agx /prsPart of CLI Coding Agents
Categories: AI Coding Agents, Code Assistants, Developer Tools