# AimeFlux for Raycast

URL: https://www.raycast.com/erdiegoant/aimeflux

> Control the AimeFlux CLI from Raycast.

- Install: raycast://extensions/erdiegoant/aimeflux
- Author: [Diego Barrera](https://www.raycast.com/erdiegoant)
- Installs: 1
- Platforms: macOS
- Categories: Productivity, Developer Tools
- Updated: 2026-10-09
- Source: https://github.com/raycast/extensions/tree/c33bf4cb4b9ad70c2b93432ee713ffb7486ed331/extensions/aimeflux/

## Commands

- **List Watch Folders**: Inspect configured AimeFlux watch folders.
- **Show Mode**: Inspect a mode with prompt, vocabulary, and replacement details.
- **List Replacements**: Browse configured replacements and remove them in context.
- **Add Replacement**: Add a global or mode-specific deterministic replacement.
- **Stop Dictation**: Stop the active AimeFlux dictation session.
- **Set Current Mode**: Change the active manual mode by name or ID.
- **List Installed Models**: Browse installed Whisper models and remove models that are not in active use.
- **List Mode Packages**: Browse installed community mode packages.
- **Import Text into History**: Import inline text into AimeFlux history.
- **Start Dictation**: Start AimeFlux dictation with optional mode and LLM cleanup.
- **Process Text**: Run one-off text processing with your configured AimeFlux modes.
- **Browse History**: Browse AimeFlux history with inline mode filtering and item actions.
- **Toggle LLM Cleanup**: Toggle the global AimeFlux LLM cleanup setting.
- **Show Current Mode**: Show the active manual mode and switch to another one.
- **Copy Latest History Item**: Copy the newest history item from AimeFlux.
- **Paste Latest History Item**: Paste the newest history item into the frontmost application.
- **List Rule Packages**: Browse installed community rule packages.

## README

### AimeFlux for Raycast

Use AimeFlux from Raycast for the day-to-day workflows that fit a launcher well: dictation control, quick text processing, history access, mode inspection, replacement management, watch-folder inspection, and community package browsing.

This extension is intentionally focused on regular usage instead of setup or maintenance tasks.

![Command List](https://github.com/raycast/extensions/raw/c33bf4cb4b9ad70c2b93432ee713ffb7486ed331/extensions/aimeflux//media/command-list.png)

#### Requirements

- `aimeflux` must be installed and available on your shell `PATH`
- the extension assumes AimeFlux uses its default config path
- `AimeFlux.app` must be running for:
  - dictation
  - LLM-enabled text processing

#### Commands

- `Start Dictation`
  Starts dictation with an optional mode and optional LLM cleanup. Closes Raycast on success.

- `Stop Dictation`
  Stops the active dictation session immediately. Closes Raycast on success.

- `Process Text`
  Processes inline text with an optional mode and optional LLM cleanup.

- `Browse History`
  Opens the latest 20 history items by default. Includes inline mode filtering, a dedicated filter form, paste and copy actions, and reprocessing for a selected item.

- `Copy Latest History Item`
  Fetches the latest history item and copies its text.

- `Paste Latest History Item`
  Fetches the latest history item and pastes its text into the frontmost application.

- `Import Text into History`
  Imports inline text into AimeFlux history, with an optional mode.

- `Show Mode`
  Shows mode prompt, vocabulary, replacements, and core metadata such as language and translation behavior.

- `Show Current Mode`
  Shows the active manual mode and lets you jump into changing it.

- `Set Current Mode`
  Changes the active manual mode by name or ID.

- `List Installed Models`
  Browses installed Whisper models and allows deletion for models that are not the current model and are not referenced by watch folders.

- `List Replacements`
  Browses configured replacements and supports in-context removal.

- `Add Replacement`
  Adds a global or mode-specific replacement.

- `List Watch Folders`
  Browses configured watch folders, shows folder settings, and lets you process a selected folder immediately.

- `List Rule Packages`
  Browses installed community rule packages and lets you enable or disable them.

- `List Mode Packages`
  Browses installed community mode packages and shows their prompts, metadata, and mode details.

![Browse History](https://github.com/raycast/extensions/raw/c33bf4cb4b9ad70c2b93432ee713ffb7486ed331/extensions/aimeflux//media/browse-history.png)

#### Notes

- The extension resolves `aimeflux` through your login shell instead of trusting Raycast's default `PATH`.
- History mode filtering from the search bar triggers a fresh CLI fetch and keeps the currently selected history filter state.
- `Import Text into History` handles transient SQLite lock cases. If AimeFlux reports `SQLITE_BUSY` but the item still lands in history, the extension treats that as success.
- Result screens focus on the actual output instead of the raw CLI command.

#### Not Included

These flows are intentionally left out of the Raycast surface:

- licensing commands
- manual config repair and migration flows
- raw fallback command execution
- model download or install flows
- watch-folder creation flows

#### Development

```bash
npm install
npm run dev
```

Production build:

```bash
npm run build
```