# loopx | huangruiteng | Knowledge Base | Instagit

Lightweight loop engineering state kernel for long-running AI agent teams. Agent-loop agnostic across Codex, Claude Code, and other coding agents, with durable goals, quota-aware auto-wake, executable todos, evidence logs, and verifiable handoffs.

GitHub Stars: 2.9k

Repository: https://github.com/huangruiteng/loopx

---

## Articles

### [How Operator Inbox Binding Works with Urgency Projection in LoopX](/huangruiteng/loopx/how-does-operator-inbox-binding-work-with-urgency-projection-loopx)

Learn how LoopX operator inbox binding uses JSON configuration and quota systems for dynamic urgency projection. Understand Lark event priorities with base extractors and operator weighting.

- Tags: how-to-guide
- Published: 2026-09-04

### [LoopX Turn Journal Runtime: How It Tracks Execution History and Enables Deterministic Replay](/huangruiteng/loopx/what-is-the-turn-journal-runtime-and-how-it-tracks-execution-history-loopx)

Discover LoopX's Turn Journal Runtime. Learn how it tracks execution history and enables deterministic replay for tamper-proof execution in this Python façade.

- Tags: internals
- Published: 2026-09-04

### [How LoopX Enforces Public/Private Boundary Scanning: A Defense-in-Depth Guide](/huangruiteng/loopx/how-does-loopx-enforce-public-private-boundary-scanning)

Discover how LoopX enforces public/private boundary scanning with its multi-layered architecture. Learn how it validates contracts, commands, and outputs against secret patterns to prevent leaks.

- Tags: how-to-guide
- Published: 2026-09-04

### [How to Debug Quota Eligibility Failures in LoopX: A Step-by-Step Diagnostic Guide](/huangruiteng/loopx/how-can-i-debug-quota-eligibility-failures-in-loopx)

Debug LoopX quota eligibility failures by tracing envelope construction, signature verification, and disposition logic. Follow our step-by-step diagnostic guide to resolve issues.

- Tags: how-to-guide
- Published: 2026-09-04

### [LoopX Status/Attention Queue Architecture: Multi-Source Aggregation and Projection](/huangruiteng/loopx/what-is-the-status-attention-queue-architecture-in-loopx)

Discover the LoopX status attention queue architecture. Learn how LoopX aggregates contract health, goal data, and scans into a centralized queue for proactive intervention and projection.

- Tags: architecture
- Published: 2026-09-04

### [How LoopX Heartbeat Automation Prompt Decides Scheduler Eligibility](/huangruiteng/loopx/how-does-loopx-heartbeat-automation-prompt-decide-scheduler-eligibility)

Discover how LoopX heartbeat automation prompts determine scheduler eligibility by checking runtime profiles, execution contexts, and mode settings.

- Tags: how-to-guide
- Published: 2026-09-04

### [LoopX Quota Spend Sources and Settlement Validation Rules: Complete Implementation Guide](/huangruiteng/loopx/what-are-the-quota-spend-sources-and-settlement-validation-rules-loopx)

Understand LoopX quota spend sources (runtime_events, visible-goal, heartbeat) and settlement validation rules for accurate budget accounting. Master implementation with this guide.

- Tags: implementation-guide
- Published: 2026-09-04

### [How the External Connector Runtime Works for Event Integration in LoopX](/huangruiteng/loopx/how-does-external-connector-runtime-work-for-event-integration-loopx)

Discover how the LoopX external connector runtime ensures safe, ordered, and acknowledged event integration. Learn about its provider-neutral, file-based system with durable privacy guarantees.

- Tags: how-to-guide
- Published: 2026-09-04

### [What Is the Peer-Agent Runtime v1 Protocol in LoopX? A Complete Technical Guide](/huangruiteng/loopx/what-is-the-peer-agent-runtime-v1-protocol-in-loopx)

Understand the LoopX Peer-Agent Runtime v1 protocol. Discover its rank-free execution model for multi-agent coordination, where peers share equal authority and work ownership is determined by claims and rules, not hierarchy.

- Tags: deep-dive
- Published: 2026-09-04

### [How LoopX Implements the Lifetime Goal Invariant: Persistence, Turn Envelopes, and Quota Validation](/huangruiteng/loopx/how-does-loopx-implement-the-lifetime-goal-invariant)

Discover how LoopX implements the lifetime goal invariant. Learn about its robust persistence, signed turn envelopes, and quota validation for reliable agent goal execution.

- Tags: deep-dive
- Published: 2026-09-04

### [Runtime Responsibility Contracts for Agent, Provider, Capability, and Kernel in LoopX](/huangruiteng/loopx/what-are-the-runtime-responsibility-contracts-for-agent-provider-capability-kernel-loopx)

Understand LoopX runtime responsibility contracts: Agent handles execution, Provider manages external calls, Capability validates transitions, and Kernel controls state and scheduling.

- Tags: architecture
- Published: 2026-09-04

### [How to Write a Custom Capability for LoopX: A Step-by-Step Developer Guide](/huangruiteng/loopx/how-do-i-write-a-custom-capability-for-loopx)

Learn to write a custom capability for LoopX with this step by step developer guide. Understand initialization, catalog entry, and CLI integration for seamless extension.

- Tags: how-to-guide
- Published: 2026-09-04

### [LoopX Canary Pre-Merge Validation Gate: How Risk-Based Testing Protects Your Main Branch](/huangruiteng/loopx/how-does-loopx-canary-validation-system-work-for-premerge-gates)

Discover how LoopX Canary uses risk-based testing for pre-merge validation gates, protecting your main branch with diff-hygiene checks, Python compilation, and smoke-suite canaries.

- Tags: how-to-guide
- Published: 2026-09-04

### [LoopX Local Server/Daemon Roadmap: From Python Auto-Daemon to Optional TypeScript Kernel](/huangruiteng/loopx/what-is-the-roadmap-for-loopx-local-server-daemon)

Discover the LoopX local server daemon roadmap. Transitioning from Python auto-daemon to an optional TypeScript kernel and a Node based daemon for multi-client use.

- Tags: roadmap
- Published: 2026-09-04

### [How LoopX Session Recovery Works After a Host Failure: A Deep Dive](/huangruiteng/loopx/how-does-loopx-session-recovery-work-after-host-failure)

Discover how LoopX handles host failures with its session recovery mechanism. Learn how LoopX recovers sessions, validates data, and resumes processing without re-execution.

- Tags: deep-dive
- Published: 2026-09-04

### [LoopX Extension vs Built‑In Capability Boundary Rules Explained](/huangruiteng/loopx/what-are-the-boundary-rules-for-loopx-extensions-versus-built-in-capabilities)

Understand LoopX boundary rules: Kernel, Capability, Provider, and Extension. Learn how LoopX separates core features from installable components for robust architecture.

- Tags: deep-dive
- Published: 2026-09-04

### [How LoopX Handles Peer-Agent Task Coordination and Handoff: A Deep Dive into Multi-Agent Orchestration](/huangruiteng/loopx/how-does-loopx-handle-peer-agent-task-coordination-and-handoff)

Discover how LoopX orchestrates multi-agent systems with peer-agent task coordination and structured handoffs. Learn about its explicit gates, budgets, and audit trails for seamless collaboration.

- Tags: deep-dive
- Published: 2026-09-04

### [Soft Claims vs Hard Leases in LoopX Todo Coordination: A Complete Technical Guide](/huangruiteng/loopx/what-is-the-difference-between-soft-claims-and-hard-leases-in-loopx-todo-coordination)

Understand LoopX's soft claims vs hard leases for todo coordination. Learn how LoopX uses these mechanisms for efficient multi-agent access and exclusive write-scope.

- Tags: deep-dive
- Published: 2026-09-04

### [What Are the Six Durable Control‑Plane Layers in LoopX Architecture?](/huangruiteng/loopx/what-are-the-six-durable-control-plane-layers-in-loopx-architecture)

Discover the six durable control-plane layers in LoopX architecture: Kernel, Capability Pack, Provider, Agent, Scheduler, and Runtime. Understand LoopX's robust design.

- Tags: deep-dive
- Published: 2026-09-04

### [How the LoopX Quota System Decides Whether a Goal Should Run](/huangruiteng/loopx/how-does-the-quota-system-decide-whether-a-goal-should-run-in-loopx)

Discover how the LoopX quota system decides if a goal runs. Learn about its multi-stage pipeline and the JSON payload determining goal execution status.

- Tags: how-to-guide
- Published: 2026-09-04

### [Understanding LoopX Kernel Capabilities, Providers, and Extensions: Architecture Explained](/huangruiteng/loopx/what-is-the-relationship-between-loopx-kernel-capabilities-providers-and-extensions)

Explore the LoopX kernel architecture. Understand how capabilities define what the system does, providers implement how, and extensions manage these providers for seamless operation.

- Tags: architecture
- Published: 2026-09-04

### [How LoopX's Turn Decision Vocabulary Works: Turn Route and Turn Result Kind Explained](/huangruiteng/loopx/how-does-loopx-turn-decision-vocabulary-work-with-loopxturnroute-and-loopxturnresultkind)

Understand LoopX's turn decision vocabulary. Learn how LoopXTurnRoute directs provider steps and LoopXTurnResultKind classifies outcomes for seamless workflow transitions.

- Tags: deep-dive
- Published: 2026-09-04

### [What Information Does the LoopX Review Packet Command Present to Owners?](/huangruiteng/loopx/loopx-review-packet-command-output)

Discover what the LoopX review_packet command reveals about decisions evidence authority material counts freshness warnings and required gate commands for owners.

- Tags: how-to-guide
- Published: 2026-09-02

### [How the LoopX State Migration Module Handles Goal State Schema Evolution](/huangruiteng/loopx/loopx-state-migration-schema-evolution)

Discover how LoopX state migration ensures schema evolution for goal states. Learn about version inspection, transformation packets, and validation for event store upgrades.

- Tags: internals
- Published: 2026-09-02

### [How the `agent_onboarding` Module Guides New Agents Through Activation](/huangruiteng/loopx/loopx-agent-onboarding-activation-process)

Discover how the agent_onboarding module automates new LoopX agent activation with identity metadata, installation commands, and runtime instructions. Streamline your onboarding process today.

- Tags: how-to-guide
- Published: 2026-09-02

### [How `quota.compute=0` Enforces a Goal-Level Hard Pause in LoopX](/huangruiteng/loopx/loopx-quota-compute-zero-hard-pause)

Discover how quota.compute=0 enforces a hard pause for Goals in LoopX, overriding all other components until the quota is increased. Learn more about this powerful scheduler feature.

- Tags: internals
- Published: 2026-09-02

### [How LoopX Projects Public-Safe Evidence Through the Lark Kanban Adapter](/huangruiteng/loopx/loopx-evidence-projection-lark-kanban-vs-dot-loopx)

Discover how LoopX leverages its .loopx/ source of truth and the Lark Kanban adapter to project public-safe evidence. Learn about sanitizing and syncing project state securely.

- Tags: how-to-guide
- Published: 2026-09-02

### [How the LoopX MCP Server Hook Exposes Lifecycle Reads and Writes via the host-integration-surface-v0 Contract](/huangruiteng/loopx/loopx-mcp-server-hook-host-integration-contract)

Learn how the LoopX MCP server hook uses the host-integration-surface-v0 contract to enable lifecycle reads and controlled writes without new authority.

- Tags: architecture
- Published: 2026-09-02

### [How the LoopX Dreaming Module Generates Ranked Todo Proposals and Evidence Probes Without Consuming Delivery Quota](/huangruiteng/loopx/loopx-dreaming-module-quota-free-proposals)

Discover how the LoopX dreaming module generates ranked todo proposals and evidence probes without using delivery quota. Learn about its innovative zero-quota analysis.

- Tags: internals
- Published: 2026-09-02

### [What Information Does a Capability Catalog Entry Provide for LoopX Registration?](/huangruiteng/loopx/loopx-capability-catalog-entry-registration)

Discover what a LoopX capability catalog entry provides for registration. Learn about CAPABILITY_ID, PROVIDERS, and CONFIG_SCHEMA metadata.

- Tags: api-reference
- Published: 2026-09-02

### [How LoopX Extension Lifecycle Isolates Package Providers from Kernel Authority](/huangruiteng/loopx/loopx-extension-lifecycle-provider-packaging)

Discover how LoopX extension lifecycle isolates package providers from kernel authority using a declarative manifest-driven approach for secure, whitelisted capabilities.

- Tags: internals
- Published: 2026-09-02

### [How LoopX Heartbeat Automation Consumes Quota `scheduler_hint` and `ack_hint.cli_args`](/huangruiteng/loopx/loopx-heartbeat-automation-quota-ack-hints)

Understand how LoopX heartbeat automation uses scheduler_hint and ack_hint.cli_args to configure runtime profiles and self-acknowledge commands, optimizing the control loop.

- Tags: how-to-guide
- Published: 2026-09-02

### [How Codex App and Host Integrations Connect to the LoopX Control Plane Without Per-Host State Machines](/huangruiteng/loopx/loopx-host-integrations-control-plane-connection)

Discover how Codex App and other host integrations connect to LoopX control plane without per-host state machines. Learn about stateless surfaces and immutable activation packets.

- Tags: architecture
- Published: 2026-09-02

### [How LoopX Differentiates Hard Boundaries (Quota Claims) from Steering Guidance (next_cli_actions)](/huangruiteng/loopx/loopx-hard-boundaries-vs-steering-guidance)

Understand how LoopX distinguishes hard boundaries like quota claims from steering guidance with next_cli_actions. Learn about enforcement and optional suggestions.

- Tags: deep-dive
- Published: 2026-09-02

### [Understanding TTL, Idempotency, and Compare-and-Swap Semantics in LoopX's `task_lease_v0` Contract](/huangruiteng/loopx/loopx-task-lease-v0-todo-ownership)

Learn how LoopX's task_lease_v0 contract ensures safe, time-bounded, and conflict-free todo ownership with TTL, idempotency, and compare-and-swap.

- Tags: internals
- Published: 2026-09-02

### [How LoopX Derives Domain Lane Projections from Kernel State Without Duplicating Authority](/huangruiteng/loopx/loopx-domain-lane-projections-kernel-state)

Learn how LoopX generates domain lane projections, like Issue Fix, from Kernel state without authority duplication. LoopX ensures read-only projections while the Kernel maintains exclusive commit rights.

- Tags: architecture
- Published: 2026-09-02

### [How LoopXTurnRoute and LoopXTurnResultKind Enums Distinguish Turn Decisions from Prose Shorthand in LoopX](/huangruiteng/loopx/loopx-enum-system-turn-decisions-prose)

Understand how LoopXTurnRoute and LoopXTurnResultKind enums differentiate turn decisions from prose shorthand for type-safe programmatic control and human-readable UI labels.

- Tags: internals
- Published: 2026-09-02

### [How the LoopX Event-Ledger Preserves Compact Evidence Across Multiple Agent Sessions](/huangruiteng/loopx/loopx-event-ledger-evidence-persistence)

Discover how the LoopX event-ledger creates immutable audit trails using compact evidence references and deterministic upserts, ensuring thread-safe data across agent sessions.

- Tags: internals
- Published: 2026-09-02

### [How Peer Agents Use Todo Claim and Todo Update to Coordinate Parallel Work](/huangruiteng/loopx/loopx-peer-agent-todo-coordination)

Discover how LoopX peer agents use todo claim and todo update to coordinate parallel work, ensuring race-condition-free execution via centralized state validation.

- Tags: deep-dive
- Published: 2026-09-02

### [How the LoopX Quota Should-Run Mechanism Determines Agent Execution Rights](/huangruiteng/loopx/loopx-quota-should-run-agent-activation)

Discover how the LoopX quota should-run mechanism validates plans, prepares candidates, and resolves routes to grant agents execution rights for the current tick.

- Tags: deep-dive
- Published: 2026-09-02

### [Capability-to-Provider Execution Path vs Kernel Writeback Control Path in LoopX](/huangruiteng/loopx/loopx-capability-provider-vs-kernel-writeback)

Understand the difference between LoopX capability-to-provider execution path and Kernel writeback control path. Learn how LoopX handles external work and state changes.

- Tags: deep-dive
- Published: 2026-09-02

### [How to Monitor LoopX Applications Using the Built-In Monitor Lane](/huangruiteng/loopx/how-to-monitor-loopx-applications)

Learn how to monitor LoopX applications efficiently. Discover the built-in monitor lane and its monitor-poll operation for effective goal state observation without quota usage.

- Tags: how-to-guide
- Published: 2026-08-15

### [LoopX Community Support: Channels, Guidelines, and Best Practices](/huangruiteng/loopx/what-is-the-loopx-community-support-like)

Explore LoopX community support channels like GitHub Issues, Discussions, and Discord. Learn guidelines and best practices for getting help with the LoopX project. No SLA guaranteed.

- Tags: community-guide
- Published: 2026-08-15

### [How to Extend LoopX Functionality: A Complete Guide to Building Custom Extensions](/huangruiteng/loopx/how-to-extend-loopx-functionality)

Learn how to extend LoopX functionality with custom extensions. Build new features using LoopX's modular system and a simple provider presentation manifest structure.

- Tags: how-to-guide
- Published: 2026-08-15

### [Core Architectural Patterns in LoopX: A Capability‑First, Extension‑Driven Design](/huangruiteng/loopx/what-are-the-architectural-patterns-used-in-loopx)

Discover LoopX's core architectural patterns: capability-first, extension-driven design. Learn how bounded contexts and layered separation enhance flexibility and modularity.

- Tags: architecture
- Published: 2026-08-15

### [How LoopX Handles Security: A Deep Dive into Its Multi-Layer Defense Architecture](/huangruiteng/loopx/how-does-loopx-handle-security)

Discover how LoopX handles security with its multi-layer defense: threat classification, secure package sources, automated tests, and hardened runtime environments for robust protection.

- Tags: deep-dive
- Published: 2026-08-15

### [Common LoopX Error Messages and Solutions: A Complete Troubleshooting Guide](/huangruiteng/loopx/what-are-the-common-loopx-error-messages-and-solutions)

Troubleshoot common LoopX errors with this complete guide. Learn solutions for validation failures, file issues, quota violations, and security breaches to keep your project running smoothly.

- Tags: troubleshooting-guide
- Published: 2026-08-15

### [How to Manage LoopX Project Versions: A Complete Guide to Contract-First Versioning](/huangruiteng/loopx/how-to-manage-loopx-project-versions)

Master LoopX project versions with our guide to contract-first versioning. Learn about schema versions, Git tags, and automated releases for seamless backward compatibility.

- Tags: how-to-guide
- Published: 2026-08-15

### [How to Deploy LoopX Applications: Complete Installation and Setup Guide](/huangruiteng/loopx/how-to-deploy-loopx-applications)

Deploy LoopX applications with our comprehensive guide. Install the CLI, connect your project, and run the autonomous loop. Follow our easy steps for a successful setup.

- Tags: how-to-guide
- Published: 2026-08-15

### [LoopX Configuration Options: Complete Guide to CLI Flags, Constants, and Environment Variables](/huangruiteng/loopx/what-are-the-loopx-configuration-options)

Master LoopX configuration options using CLI flags constants and environment variables. This guide covers all settings for efficient operation and customization.

- Tags: how-to-guide
- Published: 2026-08-15

### [How LoopX Handles Asynchronous Operations: A Deep Dive into the asyncio Architecture](/huangruiteng/loopx/how-does-loopx-handle-asynchronous-operations)

Discover how LoopX leverages Python's asyncio to manage complex asynchronous operations. Explore its architecture for efficient, non-blocking agent workflows.

- Tags: deep-dive
- Published: 2026-08-15

### [LoopX API Documentation: A Complete Guide to the Python Public Interface](/huangruiteng/loopx/what-is-the-loopx-api-documentation)

Explore the LoopX API documentation a comprehensive guide to the loopx Python package. Access stable programmatic endpoints for status, runtime, quota, and registry modules.

- Tags: api-reference
- Published: 2026-08-15

### [How to Integrate LoopX with Other Services: A Complete Guide to Value-Connector Capabilities](/huangruiteng/loopx/how-to-integrate-loopx-with-other-services)

Integrate LoopX with external services using value-connector capabilities for safe, reproducible workflows. Explore the runtime connector catalog and uniform CLI surface.

- Tags: how-to-guide
- Published: 2026-08-15

### [LoopX Testing Strategies: A Multi-Layered Quality System Explained](/huangruiteng/loopx/what-are-the-loopx-testing-strategies)

Discover LoopX testing strategies. Explore fast checks, public smokes, risk-based canaries, and model-behavior gates for robust code validation.

- Tags: best-practices
- Published: 2026-08-15

### [How to Debug LoopX Applications: A Complete Guide to Troubleshooting the AI-Agent Orchestration Framework](/huangruiteng/loopx/how-to-debug-loopx-applications)

Debug LoopX applications effectively. Learn to inspect state, query runtime health, trace errors via the CLI, registry, and state refresh, and diagnose sync failures with projection_enabled.

- Tags: how-to-guide
- Published: 2026-08-15

### [What Are the LoopX Dependencies?](/huangruiteng/loopx/what-are-the-loopx-dependencies)

Discover LoopX dependencies. This Python library boasts zero runtime dependencies, utilizing only the standard library for a streamlined experience.

- Tags: api-reference
- Published: 2026-08-15

### [LoopX Build Process: Complete Guide to Building LoopX from Source](/huangruiteng/loopx/what-is-the-build-process-for-loopx)

Master the LoopX build process. Discover how to build LoopX from source using Python 3.11 and pip. No external tools needed for wheels or editable installs.

- Tags: how-to-guide
- Published: 2026-08-15

### [How to Contribute to the LoopX Open-Source Project](/huangruiteng/loopx/how-to-contribute-to-the-loopx-project)

Learn how to contribute to the LoopX open-source project. Follow our guide to select tasks, set up your environment, and submit your first pull request to the huangruiteng/loopx repository.

- Tags: how-to-guide
- Published: 2026-08-15

### [What Programming Languages Does LoopX Use? A Complete Technical Breakdown](/huangruiteng/loopx/what-programming-languages-does-loopx-use)

Discover the programming languages powering LoopX: Python for core runtime, TypeScript for dashboards, and JavaScript for initialization. Understand the LoopX stack.

- Tags: technical-breakdown
- Published: 2026-08-15

### [Core Components of LoopX: Architecture and Module Breakdown](/huangruiteng/loopx/what-are-the-core-components-of-loopx)

Discover the core components of LoopX: Registry, Control Plane, and Runtime. Understand its architecture and module breakdown for declarative policies and efficient execution.

- Tags: architecture
- Published: 2026-08-15

### [Where to Find Example Projects Using LoopX: Complete Guide to Samples and Starter Templates](/huangruiteng/loopx/example-projects-using-loopx)

Discover LoopX example projects in the huangruiteng/loopx repository. Explore nine Python scripts demonstrating worker registration, agent coordination, benchmarks, and custom runtimes.

- Tags: getting-started
- Published: 2026-08-14

### [What Are the Main Development Goals for LoopX? 5 Core Principles Explained](/huangruiteng/loopx/loopx-development-goals)

Discover LoopX's core development goals. Learn about its 5 principles for creating a reviewable, restartable, and hand-off friendly AI agent control plane.

- Tags: deep-dive
- Published: 2026-08-14

### [What Is the Community Support Like for LoopX? A Complete Guide](/huangruiteng/loopx/loopx-community-support)

Discover LoopX community support options including GitHub Issues, Discussions, Discord, and private reporting for security. Get help and contribute to this open-source project.

- Tags: community-guide
- Published: 2026-08-14

### [How to Debug Issues in LoopX: A Step-by-Step Troubleshooting Guide](/huangruiteng/loopx/how-to-debug-loopx-issues)

Debug LoopX effectively with this step-by-step guide. Learn to use dry-run flags, inspect runtime projection routes, and monitor health with the HTTP status server for seamless troubleshooting.

- Tags: how-to-guide
- Published: 2026-08-14

### [LoopX Best Practices: A Complete Guide to Building Robust AI Agent Workflows](/huangruiteng/loopx/best-practices-for-using-loopx)

Master LoopX best practices for building robust AI agent workflows. Learn to use state machines, interaction contracts, and structured feedback for efficient AI development.

- Tags: best-practices
- Published: 2026-08-14

### [LoopX Release History and Changelog: Complete Version Guide](/huangruiteng/loopx/loopx-release-history-changelog)

Explore the LoopX release history and changelog. Discover milestone updates and detailed per-release notes to understand every LoopX version.

- Tags: release-history
- Published: 2026-08-14

### [How to Test LoopX Locally: A Complete Guide to Installation and Validation](/huangruiteng/loopx/how-to-test-loopx-locally)

Learn how to test LoopX locally with this complete guide. Install the control plane, validate with loopx doctor, and run smoke tests from examples.

- Tags: how-to-guide
- Published: 2026-08-14

### [LoopX Limitations and Known Issues: A Complete Technical Guide](/huangruiteng/loopx/loopx-known-issues-limitations)

Explore LoopX limitations and known issues impacting production deployments. Understand critical factors like scheduling, dependencies, failures, corruption, and upgrades.

- Tags: deep-dive
- Published: 2026-08-14

### [LoopX Performance Characteristics: I/O-Bound Architecture and Optimization Strategies](/huangruiteng/loopx/loopx-performance-characteristics)

Discover LoopX performance characteristics, an I/O-bound orchestration engine. Learn optimization strategies for disk I/O, caching, and horizontal scaling with multi-agent parallelism.

- Tags: performance
- Published: 2026-08-14

### [LoopX Input and Output Formats: A Complete Guide to CLI Data Handling](/huangruiteng/loopx/loopx-supported-input-output-formats)

Master LoopX input and output formats including JSON, Markdown, Mermaid, and SVG. Control CLI data handling and presentation layer inputs with ease. Learn more!

- Tags: api-reference
- Published: 2026-08-14

### [How LoopX Handles Data Processing: From Ingestion to Kernel State](/huangruiteng/loopx/how-loopx-handles-data-processing)

Discover how LoopX processes data from ingestion to kernel state via a deterministic control-plane pipeline. Learn about observation validation, state transitions, and durable kernel persistence.

- Tags: how-to-guide
- Published: 2026-08-14

### [LoopX Architecture Core Components: The 6 Control-Plane Layers Explained](/huangruiteng/loopx/loopx-core-architecture-components)

Discover the LoopX architecture's 6 control-plane layers and 4-part runtime model. Understand how state ownership and execution logic are separated for robust system design.

- Tags: architecture
- Published: 2026-08-14

### [How to Build LoopX from Source: Complete Python 3.11+ Installation Guide](/huangruiteng/loopx/how-to-build-loopx-from-source)

Build LoopX from source with this complete Python 3.11+ installation guide. Learn to clone the repo and install using pip for standard or editable modes.

- Tags: how-to-guide
- Published: 2026-08-14

### [LoopX Basic Usage Examples: A Quick Start Guide for AI Agent Control-Planes](/huangruiteng/loopx/loopx-basic-usage-examples)

Learn LoopX basic usage examples and master AI agent control planes. This quick start guide covers connect, start-goal, claim/update, and review-packet workflows for durable AI objectives.

- Tags: getting-started
- Published: 2026-08-14

### [Where to Find LoopX Documentation: A Complete Guide to Guides, API References, and Architecture Docs](/huangruiteng/loopx/loopx-documentation)

Find comprehensive LoopX documentation including guides, API references, and architecture details. Access docs in the huangruiteng/loopx repository or the online portal at https://huangruiteng.github.io/loopx/docs/.

- Tags: getting-started
- Published: 2026-08-14

### [What Is the License for LoopX? Understanding the MIT License Terms](/huangruiteng/loopx/loopx-license)

Discover the LoopX MIT license terms. Use, modify, and distribute LoopX freely with just copyright notice attribution. Get started today!

- Tags: license-information
- Published: 2026-08-14

### [LoopX Dependencies: Understanding the Zero-Runtime-Dependency Design](/huangruiteng/loopx/loopx-dependencies)

Explore LoopX dependencies and its zero-runtime-dependency design. Discover how LoopX leverages the Python standard library for efficient, dependency-free operation.

- Tags: internals
- Published: 2026-08-14

### [What Programming Languages Are Used in the LoopX Project?](/huangruiteng/loopx/loopx-programming-languages)

Discover the programming languages powering the LoopX project. LoopX utilizes Python, TypeScript, and JavaScript for its runtime and dashboards.

- Tags: getting-started
- Published: 2026-08-14

### [What Is the Main Purpose of the huangruiteng/loopx Repository? A Durable Control Plane for Long-Running AI Agents](/huangruiteng/loopx/what-is-huangruiteng-loopx-purpose)

Discover huangruiteng/loopx, a provider-neutral control plane for durable AI agent loops. Maintain context across turns, tools, and agents with secure state management.

- Tags: deep-dive
- Published: 2026-08-14

### [How to Build and Compile LoopX: A Complete Installation and Packaging Guide](/huangruiteng/loopx/what-are-the-build-or-compilation-steps-for-loopx)

Install and compile LoopX effortlessly. Discover the straightforward setuptools commands for this pure-Python library, making setup quick and easy.

- Tags: how-to-guide
- Published: 2026-08-13

### [How to Contribute to LoopX: From Setup to Your First Pull Request](/huangruiteng/loopx/how-can-i-contribute-to-the-loopx-project)

Contribute to LoopX by selecting a task, setting up your environment with install-local.sh, and submitting your first pull request. Learn LoopX contribution steps.

- Tags: how-to-guide
- Published: 2026-08-13

### [What Version Control System Is Used for LoopX? Git Implementation Explained](/huangruiteng/loopx/what-version-control-system-is-used-for-loopx)

Discover LoopX's version control system. Learn how Git is implemented in the LoopX repository with full history and standard configurations for Git workflows.

- Tags: internals
- Published: 2026-08-13

### [Key Data Flow Paths in LoopX: From Registry to Runtime State](/huangruiteng/loopx/what-are-the-key-data-flow-paths-within-loopx)

Explore LoopX data flow paths from registry to runtime state. Understand configuration to execution feedback loops for efficient development.

- Tags: deep-dive
- Published: 2026-08-13

### [How LoopX Interacts with External Systems and APIs: A Deep Dive into the Capability Framework](/huangruiteng/loopx/how-does-loopx-interact-with-external-systems-or-apis)

Discover how LoopX interacts with external systems and APIs using its capability framework. Centralized transport and error normalization ensure seamless integration and robust communication.

- Tags: deep-dive
- Published: 2026-08-13

### [What Testing Framework Is Used with LoopX? A Deep Dive into Its Pytest Setup](/huangruiteng/loopx/is-there-a-testing-framework-used-with-loopx)

Discover the pytest testing framework powering LoopX. Explore test organization in the tests directory and shared fixtures in conftest.py.

- Tags: testing-framework
- Published: 2026-08-13

### [What Are the Dependencies of the Main LoopX Files?](/huangruiteng/loopx/what-are-the-dependencies-of-the-main-loopx-files)

Discover LoopX dependencies. This Python library needs only the standard library for core functionality. Optional testing tools are in the test extra group.

- Tags: internals
- Published: 2026-08-13

### [How Logging Is Handled in LoopX: A Layered Privacy-First Strategy](/huangruiteng/loopx/how-is-logging-handled-in-loopx)

Discover how LoopX implements a five-layer logging strategy to protect sensitive data. Learn about its privacy-first approach ensuring no private information leaks.

- Tags: how-to-guide
- Published: 2026-08-13

### [LoopX Performance Characteristics: I/O Bottlenecks, Caching, and Scaling Strategies](/huangruiteng/loopx/what-are-the-performance-characteristics-of-loopx)

Discover LoopX performance characteristics. Learn how to overcome I/O bottlenecks and optimize caching for efficient scaling of this Python orchestration engine.

- Tags: performance
- Published: 2026-08-13

### [Does LoopX Support Asynchronous Operations? A Deep Dive into Its Async Architecture](/huangruiteng/loopx/does-loopx-support-asynchronous-operations)

Discover how LoopX leverages Python asyncio for robust asynchronous operations. Explore its coroutine-based architecture for efficient, non-blocking workflows.

- Tags: deep-dive
- Published: 2026-08-13

### [How Error Handling Is Implemented in LoopX: Python CLI Exception Patterns Explained](/huangruiteng/loopx/how-is-error-handling-implemented-in-loopx)

Discover LoopX's layered error handling in Python. Learn how exceptions are managed, logged, and presented to users for effective debugging.

- Tags: how-to-guide
- Published: 2026-08-13

### [Typical Use Cases for LoopX: Managing Long-Running AI Agent Workflows with a Local-First Control Plane](/huangruiteng/loopx/what-are-the-typical-use-cases-for-loopx)

Discover LoopX use cases for managing long-running AI agent workflows. Learn how LoopX provides durable, auditable state for AI agents locally.

- Tags: getting-started
- Published: 2026-08-13

### [How to Extend and Customize LoopX: A Complete Guide to Extensions and Custom Runtimes](/huangruiteng/loopx/can-loopx-be-extended-or-customized)

Discover how to extend and customize LoopX with its scaffold-based system, provider implementations, and sandboxed runtimes. Add new capabilities easily without core code modification.

- Tags: how-to-guide
- Published: 2026-08-13

### [Main Functions and Methods in the LoopX Entry Point File](/huangruiteng/loopx/what-are-the-main-functions-or-methods-in-the-entry-point-file)

Discover the main functions and methods in the LoopX entry point file. Learn how loopx/entrypoint.py routes CLI commands and checks versions for efficient use.

- Tags: api-reference
- Published: 2026-08-13

### [Data Structures in LoopX: Immutable Contracts and Type-Safe Runtime Collections](/huangruiteng/loopx/what-kind-of-data-structures-does-loopx-utilize)

Explore LoopX data structures: frozen dataclasses, type-safe enums, TypedDict, and Protocols. Learn how LoopX separates immutable contracts from mutable runtime state for robust applications.

- Tags: deep-dive
- Published: 2026-08-13

### [Is There a Configuration File for LoopX? Understanding the .loopx Directory Structure](/huangruiteng/loopx/is-there-a-configuration-file-for-loopx)

Discover LoopX configuration. Learn about the .loopx directory structure, registry.json, and optional config files for project settings. Understand LoopX setup.

- Tags: how-to-guide
- Published: 2026-08-13

### [Core Modules and Components of LoopX: Runtime, Control Plane, and Registry Explained](/huangruiteng/loopx/what-are-the-core-modules-or-components-of-loopx)

Explore the core LoopX modules: Runtime, Control Plane, and Registry. Understand goal lifecycle, turn-based execution, and agent tracking in this technical deep dive.

- Tags: internals
- Published: 2026-08-13

### [Main Entry Point for the LoopX Application: CLI Startup Architecture Explained](/huangruiteng/loopx/where-is-the-main-entry-point-for-the-loopx-application)

Discover the LoopX application's main entry point. Explore the CLI startup architecture, from pyproject.toml to loopx/cli_rollout.py, and understand how LoopX launches.

- Tags: architecture
- Published: 2026-08-13

### [LoopX Architecture Explained: Local-First Control-Plane Design for AI Agents](/huangruiteng/loopx/how-is-loopx-architected)

Discover the LoopX architecture: a local-first control plane design separating state management from execution runtimes across six layers. Learn its four runtime responsibilities.

- Tags: architecture
- Published: 2026-08-13

### [What Is the Primary Purpose of the LoopX Project?](/huangruiteng/loopx/what-is-the-primary-purpose-of-the-loopx-project)

Discover the primary purpose of the LoopX project. This open control plane orchestrates AI agents and teams, maintaining durable loop state for efficient execution.

- Tags: getting-started
- Published: 2026-08-13

### [How LoopX Is Structured: A Three-Layer Architecture for Long-Running Agents](/huangruiteng/loopx/how-is-loopx-structured)

Discover LoopX's three-layer architecture: core control-plane, CLI orchestration, and extensible presentation. Keep runtime logic pure and expose rich functionality.

- Tags: architecture
- Published: 2026-08-11

### [How to Test LoopX: A Complete Guide to Unit Tests, Smokes, and Canary Gates](/huangruiteng/loopx/how-to-test-loopx)

Learn how to test LoopX effectively with unit tests, smokes, and canary gates. This guide covers all you need to validate your AI agent control-plane changes.

- Tags: how-to-guide
- Published: 2026-08-11

### [LoopX Build Tools: Setuptools and MkDocs Configuration Guide](/huangruiteng/loopx/what-are-the-projects-build-tools)

Discover LoopX build tools: setuptools for Python packaging and MkDocs for documentation. Learn how to configure pyproject.toml and mkdocs.yaml for efficient development.

- Tags: how-to-guide
- Published: 2026-08-11

### [Use Cases for LoopX: Managing Long-Running AI Agents with Durable State](/huangruiteng/loopx/what-are-the-use-cases-for-loopx)

Discover LoopX use cases for managing long-running AI agents with durable state. Enable multi-day projects, issue lifecycle management, and multi-agent coordination effortlessly.

- Tags: use-cases
- Published: 2026-08-11

### [Where to Find LoopX Documentation: Complete Guide to Guides, API Reference, and Architecture](/huangruiteng/loopx/where-can-i-find-loopx-documentation)

Find LoopX documentation easily in the huangruiteng/loopx repository docs directory or at the published static site. Access guides, API reference, and architecture details.

- Tags: api-reference
- Published: 2026-08-11

### [LoopX License: Understanding the MIT License Terms for the huangruiteng/loopx Repository](/huangruiteng/loopx/what-is-the-license-for-loopx)

Understand the MIT License for the huangruiteng/loopx repository. Learn about commercial use, modification, and distribution terms for LoopX.

- Tags: getting-started
- Published: 2026-08-11

### [LoopX vs Other Agent Frameworks: 7 Architectural Differences Explained](/huangruiteng/loopx/what-is-the-difference-between-loopx-and-similar-projects)

Discover LoopX architecture and its 7 key differences from agent frameworks like LangChain. Understand stateful control planes for durable multi-agent loops.

- Tags: comparison
- Published: 2026-08-08

### [How to Deploy LoopX: Complete Installation Guide for the Local‑First Control Plane](/huangruiteng/loopx/how-to-deploy-loopx)

Deploy LoopX, a local-first control plane, with our complete installation guide. Install via a single script and connect to any project directory.

- Tags: how-to-guide
- Published: 2026-08-08

### [LoopX Limitations: 8 Architectural Constraints You Need to Know](/huangruiteng/loopx/what-are-the-limitations-of-loopx)

Explore LoopX limitations and 8 key architectural constraints. Understand LoopX is a control plane, not a full agent framework, to optimize your usage.

- Tags: deep-dive
- Published: 2026-08-08

### [How to Get Support for LoopX: Contact Channels, GitHub Issues, and Community Resources](/huangruiteng/loopx/how-to-get-support-for-loopx)

Get LoopX support through WeChat, GitHub issues, or community resources. Find clear instructions and solutions in our documented repository.

- Tags: getting-started
- Published: 2026-08-08

### [Security Implications of Using LoopX: How the Public-Safe Architecture Protects Private Data](/huangruiteng/loopx/what-are-the-security-implications-of-using-loopx)

Discover LoopX security implications. Its public-safe architecture uses automated detection and validation to protect private data from exposure in public artifacts.

- Tags: security
- Published: 2026-08-08

### [How to Update LoopX to the Latest Version: A Step-by-Step Guide](/huangruiteng/loopx/how-to-update-loopx)

Easily update LoopX with our step-by-step guide. Learn to preview changes, execute updates, and rollback to previous versions using simple commands. Keep LoopX current effortlessly.

- Tags: how-to-guide
- Published: 2026-08-08

### [LoopX Best Practices: A Complete Guide to Local-First AI Agent Control Planes](/huangruiteng/loopx/what-are-the-best-practices-for-using-loopx)

Master LoopX best practices for local-first AI agent control. Learn to manage goals as state, use explicit contracts, and structure feedback for efficient AI execution.

- Tags: best-practices
- Published: 2026-08-08

### [How to Configure LoopX: CLI Commands, Environment Variables, and Goal-Level Settings](/huangruiteng/loopx/how-to-configure-loopx)

Configure LoopX using CLI commands and environment variables. Learn goal-level settings with preview and execute options for effective runtime control.

- Tags: how-to-guide
- Published: 2026-08-08

### [Loopx Performance Considerations: I/O Bottlenecks, Caching, and Scaling Strategies](/huangruiteng/loopx/what-are-the-performance-considerations-for-loopx)

Optimize Loopx performance by addressing I/O bottlenecks and caching. Discover essential strategies for scaling your Loopx deployments and ensuring smooth operation.

- Tags: performance
- Published: 2026-08-08

### [How to Integrate LoopX with CI Systems, Chat Bots, and Custom Tools](/huangruiteng/loopx/how-to-integrate-loopx-with-other-tools)

Integrate LoopX with CI systems chat bots and custom tools using its three-layer architecture Connect any pipeline bot or script without copying code

- Tags: how-to-guide
- Published: 2026-08-08

### [LoopX Roadmap Explained: 5 Development Tracks for the Control-Plane Dashboard](/huangruiteng/loopx/what-is-the-roadmap-for-loopx)

Discover the LoopX roadmap, detailing five development tracks that will evolve the control plane into a public safe dashboard for maintainers and operators.

- Tags: roadmap
- Published: 2026-08-08

### [How to Debug LoopX: A Complete Guide to Troubleshooting the AI-Agent Orchestration Framework](/huangruiteng/loopx/how-to-debug-loopx)

Debug LoopX easily with this comprehensive guide. Master dry-run flags, status server, and layered architecture for efficient AI agent orchestration troubleshooting.

- Tags: how-to-guide
- Published: 2026-08-08

### [LoopX Use Cases: 6 Practical Patterns for Long-Running AI Agent Workflows](/huangruiteng/loopx/what-are-the-common-use-cases-for-loopx)

Discover LoopX use cases for AI agents. Explore 6 practical patterns for long-running workflows like multi-day projects, issue resolution, and agent coordination.

- Tags: use-cases
- Published: 2026-08-08

### [How to Set Up a Development Environment for LoopX: A Step-by-Step Guide to Installing and Running the Autonomous Agent Framework](/huangruiteng/loopx/how-to-set-up-a-development-environment-for-loopx)

Set up your LoopX development environment quickly. Follow this guide to clone, install, verify, and demo the autonomous agent framework. Get started with LoopX today.

- Tags: getting-started
- Published: 2026-08-08

### [Loopx License: Understanding the MIT Licensing Terms in huangruiteng/loopx](/huangruiteng/loopx/what-are-the-licensing-terms-for-loopx)

Understand the MIT License terms for the LoopX project. Learn about commercial use, modification, and distribution rights for huangruiteng/loopx.

- Tags: licensing
- Published: 2026-08-08

### [How to Run LoopX Locally: Complete Local-First Setup Guide](/huangruiteng/loopx/how-to-run-loopx-locally)

Run LoopX locally with this complete setup guide. Install easily and connect your project to drive long-running AI agent loops efficiently. Get started now.

- Tags: how-to-guide
- Published: 2026-08-08

### [What Are the LoopX Dependencies? Understanding the Zero-Runtime-Dependency Framework](/huangruiteng/loopx/what-are-the-dependencies-of-loopx)

Discover LoopX's zero runtime dependencies. This Python framework leverages the standard library, needing only Python 3.11+. Learn how LoopX simplifies development.

- Tags: internals
- Published: 2026-08-08

### [How to Contribute to LoopX: A Complete Guide for Open-Source Contributors](/huangruiteng/loopx/how-to-contribute-to-loopx)

Learn how to contribute to LoopX with this guide. Follow our steps to set up your environment, make changes, and submit a pull request to the LoopX repository.

- Tags: how-to-guide
- Published: 2026-08-08

### [Understanding the Architecture of LoopX: A Six-Layer Control Plane for AI Workflows](/huangruiteng/loopx/what-is-the-architecture-of-loopx)

Discover the LoopX architecture: a six-layer control plane for AI workflows. Learn how LoopX ensures inspectable and recoverable long-running AI tasks with its provider-neutral design.

- Tags: architecture
- Published: 2026-08-08

### [How to Use LoopX for Data Processing: A Complete Guide to Provider-Neutral Pipelines](/huangruiteng/loopx/how-to-use-loopx-for-data-processing)

Learn how to use LoopX for data processing with this complete guide. Discover its provider-neutral pipelines, quota-based scheduling, and auditable state management for efficient data orchestration.

- Tags: how-to-guide
- Published: 2026-08-08

### [Main Features of LoopX: A Deep Dive into the Stateful AI Agent Control-Plane](/huangruiteng/loopx/what-are-the-main-features-of-loopx)

Discover LoopX's main features: persistent goal management, quota-driven scheduling, and typed todo orchestration for reviewable, restartable AI agent workflows. Enhance your agent control.

- Tags: deep-dive
- Published: 2026-08-08

### [What Programming Language Is LoopX Written In? A Complete Python Architecture Guide](/huangruiteng/loopx/what-programming-language-is-loopx-written-in)

Discover LoopX's programming language. This guide details its Python architecture, version requirements, and pure-Python implementation with no external dependencies.

- Tags: architecture
- Published: 2026-08-08

### [How to Install LoopX: Complete Setup Guide for the Stateful Control-Plane](/huangruiteng/loopx/how-to-install-loopx)

Easily install LoopX with our complete setup guide. Follow simple commands to get the stateful control-plane running and verify your installation with loopx doctor.

- Tags: getting-started
- Published: 2026-08-08

### [What is LoopX? Understanding the Open-Source AI Agent Control Plane](/huangruiteng/loopx/what-is-loopx)

Discover LoopX an open-source AI agent control plane. It provides a durable state layer for long-running agents tracking objectives evidence and more. Learn how LoopX separates agent runtime from its state kernel.

- Tags: getting-started
- Published: 2026-08-08

### [LoopX Goal Lifecycle: From Creation to Completion in Open-Source Autonomous Task Management](/huangruiteng/loopx/loopx-goal-lifecycle-creation-completion)

Explore the 10-stage LoopX goal lifecycle, from creation to completion. Understand how LoopX autonomously manages tasks in this open-source system.

- Tags: deep-dive
- Published: 2026-08-07

### [How to Configure Self-Repair Behavior for Stalled Goals in LoopX: A Complete Guide](/huangruiteng/loopx/loopx-configure-self-repair-stalled-goals)

Configure self-repair for stalled LoopX goals. Learn how to automatically recover by enabling self-repair with three CLI flags for seamless goal re-planning and progress.

- Tags: how-to-guide
- Published: 2026-08-07

### [LoopX Extension and Capability Registration Patterns Explained](/huangruiteng/loopx/loopx-extension-capability-registration-patterns)

Understand LoopX extension and capability registration patterns. Discover how LoopX uses TOML manifests and a CapabilityRegistry for runtime validation and linking of providers and implementations.

- Tags: deep-dive
- Published: 2026-08-07

### [Understanding the LoopX Status Data Contract and Attention Queue Derivation](/huangruiteng/loopx/loopx-status-data-contract-attention-queue)

Explore the LoopX status data contract and learn how the attention queue is derived. Understand health metrics, runtime summaries, and multi-stage enrichment for LoopX.

- Tags: deep-dive
- Published: 2026-08-07

### [How to Implement Bounded Orchestration for Parallel Agent Work in LoopX](/huangruiteng/loopx/loopx-bounded-orchestration-parallel-agent-work)

Learn to implement bounded orchestration for parallel agent work in LoopX. Set max_children in your goal's orchestration contract to limit sub-agents effectively.

- Tags: how-to-guide
- Published: 2026-08-07

### [LoopX CLI Commands: Complete Reference and Usage Guide](/huangruiteng/loopx/loopx-cli-commands-usage-patterns)

Master LoopX CLI commands with this comprehensive reference. Discover over 50 sub-commands for operators, maintainers, and automation. Enhance your workflow today.

- Tags: api-reference
- Published: 2026-08-07

### [How LoopX Manages Authority Sources and Conflict Resolution: A Deep Dive into Registry Architecture](/huangruiteng/loopx/loopx-authority-sources-conflict-resolution)

Discover how LoopX manages authority sources and conflict resolution with its registry architecture. Learn about configurable rules, boundary enforcement, and risk-based aggregation for seamless conflict resolution.

- Tags: deep-dive
- Published: 2026-08-07

### [How to Connect LoopX to External Collaboration Surfaces like Lark Kanban](/huangruiteng/loopx/loopx-connect-lark-kanban-external-collaboration)

Connect LoopX to Lark Kanban easily. This guide shows how to project LoopX control-plane state (goals, todos, metrics) into Feishu/Lark Base boards using the CLI and Python adapters.

- Tags: how-to-guide
- Published: 2026-08-07

### [What Are LoopX Presets and How to Use Them for Common Workflows?](/huangruiteng/loopx/loopx-presets-usage-common-workflows)

Discover LoopX presets, reusable configuration objects for common automation tasks. Learn how to use these starter packs via CLI commands to streamline your workflows.

- Tags: how-to-guide
- Published: 2026-08-07

### [How LoopX Handles Goal Recovery and State Repair: A Technical Deep Dive](/huangruiteng/loopx/loopx-goal-recovery-state-repair)

Discover how LoopX handles goal recovery and state repair. Learn about its three-layer system using turn envelopes, repair hints, and the loopx-self-repair skill for deterministic fixes.

- Tags: deep-dive
- Published: 2026-08-07

### [LoopX Quota Should‑Run Contract: How Agent Eligibility Is Determined](/huangruiteng/loopx/loopx-quota-should-run-contract-agent-eligibility)

Understand the LoopX quota should-run contract. Discover how it evaluates agent eligibility by analyzing compute limits, health, operator gates, and slot consumption.

- Tags: how-to-guide
- Published: 2026-08-07

### [How to Set Up Custom Agent Runner Integration with LoopX: A Complete Guide](/huangruiteng/loopx/loopx-custom-agent-runner-integration-setup)

Learn to set up custom agent runner integration with LoopX. This guide covers installing the CLI, consuming packets, executing agent turns, and applying scheduler hints for seamless operation.

- Tags: how-to-guide
- Published: 2026-08-07

### [How to Enable LoopX Explore Capability for Experiment Tracking](/huangruiteng/loopx/loopx-explore-capability-experiment-tracking)

Unlock LoopX Explore capability for powerful experiment tracking. Learn how to enable this feature to record exploration history blockers and findings for better project insights.

- Tags: how-to-guide
- Published: 2026-08-07

### [How LoopX Manages Todo States, Claims, and Leases: A Complete Technical Guide](/huangruiteng/loopx/loopx-todo-states-claims-leases-management)

Discover how LoopX manages todo states, claims, and leases with its metadata-driven system. Learn about exclusive agent ownership and CLI validation for robust todo management.

- Tags: how-to-guide
- Published: 2026-08-07

### [LoopX Turn Decision Vocabulary: LoopXTurnRoute and LoopXTurnResultKind Explained](/huangruiteng/loopx/loopx-turn-decision-vocabulary-typed-contracts)

Understand LoopX turn decision vocabulary: LoopXTurnRoute for routing intent and LoopXTurnResultKind for outcome classification. Declaratively manage adaptive execution paths.

- Tags: api-reference
- Published: 2026-08-07

### [How to Configure User Gates and Approval Workflows in LoopX](/huangruiteng/loopx/loopx-configure-user-gates-approval-workflows)

Learn to configure user gates and approval workflows in LoopX. Block agent execution until decisions are made via CLI or dashboard for seamless human oversight.

- Tags: how-to-guide
- Published: 2026-08-07

### [LoopX Public/Private Boundary Policy and Contract Scanning Explained](/huangruiteng/loopx/loopx-public-private-boundary-policy-contract-scanning)

Understand LoopX public/private boundary policy and contract scanning. Learn how LoopX prevents sensitive data leaks and ensures contract integrity with automated checks.

- Tags: deep-dive
- Published: 2026-08-07

### [How LoopX Handles Multi-Agent Coordination and Peer Handoffs: Architecture and Implementation](/huangruiteng/loopx/loopx-multi-agent-coordination-peer-handoffs)

Discover how LoopX architecture handles multi-agent coordination and peer handoffs. Learn about isolated execution lanes, common goal surfaces, and runtime observation for seamless transitions.

- Tags: architecture
- Published: 2026-08-07

### [LoopX Capabilities Explained: How to Use Issue‑Fix, Content‑Ops, and ML‑Experiment](/huangruiteng/loopx/loopx-capabilities-usage-issue-fix-content-ops-ml-experiment)

Explore LoopX capabilities like issue-fix content-ops and ml-experiment. Learn how to use these modular workflows via CLI or programmatically to streamline your projects. Discover LoopX today.

- Tags: how-to-guide
- Published: 2026-08-07

### [How to Integrate LoopX with Codex App for Heartbeat Automation](/huangruiteng/loopx/loopx-codex-app-heartbeat-integration)

Automate heartbeats by integrating LoopX with Codex App. Learn to enable profiles, build prompts, and schedule commands for seamless operation. Enhance your system's reliability today.

- Tags: how-to-guide
- Published: 2026-08-07

### [LoopX Six Durable Control-Plane Layers: Architecture Explained](/huangruiteng/loopx/loopx-control-plane-layers-architecture)

Explore the LoopX architecture and its six durable control-plane layers: Registry, Goal State, Run Log, Run History, Status/Attention Queue, and Compute Quota. Understand the immutable backbone of the huangruiteng/loopx system.

- Tags: architecture
- Published: 2026-08-07

### [How LoopX Manages Quota Allocation and Compute Budgets for Long-Running Agent Goals](/huangruiteng/loopx/loopx-quota-allocation-compute-budgets)

LoopX efficiently manages compute budgets using a fractional quota system. Discover how it tracks runtime to control agent eligibility, throttling, and pausing for long-running goals.

- Tags: how-to-guide
- Published: 2026-08-07