Helixent is a library for building ReAct-style AI agent loops, optimized for coding tasks within the Bun JavaScript runtime. It targets developers and researchers seeking a performant, extensible framework for creating intelligent agents with practical coding tools and a CLI. Its Bun-native approach offers speed and developer experience, while its middleware-centric design ensures easy customization.

How It Works

The architecture comprises three layers: Foundation (model abstraction, messages, tools), Agent Loop (ReAct cycle with state and middleware), and Coding Agent (domain-specific tools). It leverages Bun for asynchronous performance and single-file binaries. Key features include a middleware-ready loop for deep customization and a suite of developer utilities.

Quick Start & Requirements

Install globally via npm install -g helixent@latest and run helixent, or use npx helixent@latest without installation. Development requires the Bun runtime. A demo video is available.

Highlighted Details

• Model Foundation: Unified LLM provider abstraction for easy model swapping.
• Agent Loop: Reusable ReAct loop with first-class middleware for extensibility and human-in-the-loop approvals.
• Coding Agent: Practical developer tools (bash, file operations, search, patching) and todo-list planning.
• CLI & TUI: Interactive command-line interface with Text User Interface for rapid iteration.
• Long-term Memory: Integrates project guidance from AGENTS.md at the repository root.

Maintenance & Community

The README provides no specific details on maintainers, community channels, sponsorships, or a public roadmap.

Licensing & Compatibility

No license information is specified in the README, posing a potential adoption blocker for commercial use.

Limitations & Caveats

Active development is indicated by planned features like sub-agents and multi-agent collaboration, suggesting current limitations. Build instructions mention macOS specifically, implying potential platform-specific build considerations.