# @vtstech/pi-react-fallback

ReAct fallback extension for the [Pi Coding Agent](https://github.com/badlogic/pi-mono).

Text-based tool calling bridge for models without native function calling support.

```bash
# Install as part of the bundle
pi install git:github.com/VTSTech/pi-coding-agent

# Or install individually
pi install "npm:@vtstech/pi-react-fallback"
```

## How It Works

Automatically loaded — no commands needed. When a model lacks native tool calling:

- Parses `Thought:`, `Action:`, `Action Input:` patterns from model output
- **Multi-dialect support**: classic ReAct (`Action:`), Function (`Function:`), Tool (`Tool:`), Call (`Call:`) — each with dynamically-built regex patterns
- Multiple regex strategies including parenthetical style and loose matching
- Bridges text-based tool calls into Pi's native tool execution pipeline
- Falls back when native tool calls fail
- Disabled by default; toggle via `/react-mode` with persistent config across restarts

## Links

- [Full Documentation](https://github.com/VTSTech/pi-coding-agent#react-fallback-react-fallbackts)
- [Changelog](https://github.com/VTSTech/pi-coding-agent/blob/main/CHANGELOG.md)

## License

MIT — [VTSTech](https://www.vts-tech.org)