# Figxit > Figxit is IDE-style autocomplete for the macOS terminal, for zsh, bash, and fish. It completes commands, subcommands, options, package.json scripts, and Makefile targets as you type, ordered by what you use most in the current project. It is a free, open source replacement for Fig's autocomplete. - Website: https://figxit.com/ - Download: https://figxit.com/download/Figxit.dmg - Source: https://github.com/en3sis/figxit - Version: 0.7.0 - Licence: MIT, open source, free - Platform: Apple Silicon, macOS 13 or later. zsh, bash 5 or later, or fish 4. tmux is optional - No account, no AI chat, no telemetry ## What it does Figxit completes commands for 700+ command line tools and for your own project. The list is a native macOS window. It does not take keyboard focus, and nothing is drawn inside your terminal. ### Project targets and scripts `make ` lists the targets of the Makefile in the current folder. `npm run `, `pnpm `, `yarn `, and `bun run ` list the scripts of package.json, with the command each one runs. There is no setup for each project. For a Makefile, the right column shows the comments that many projects already write. `##@` starts a section and `##` after a target is its help text. Both are optional. ```make ##@ Development dev: ## Start the stack with hot reload dev-down: ## Stop the stack ##@ Tests test: ## Run the unit tests ``` ### Subcommands for 700+ tools Figxit loads the open source Fig completion specs. Type a command and a space to see its subcommands, each with a one-line description. Specs also supply live values, such as git branches after `git checkout `, hosts after `ssh `, and files and folders where a command takes a path. ### Options with descriptions Type a dash to see the options of the command on the line. Options you have already typed are hidden from the list. ### Ranked by your history Figxit reads your [Atuin](https://atuin.sh) history database, read-only. A word scores higher when you used it in the same folder, in the same repository, or recently. Without Atuin the popup still works, in the order the sources give. For a command that has a spec, history from other folders is not shown. This keeps scripts from one project out of the list in another. ### Local only Your commands and history stay on your Mac. The app does not report what you type or how you use it. Its only network request is the daily update check, which reads one file from figxit.com. You can turn the check off in Settings. There is no account. ### No typing delay The shell hook sends the line to the engine after each key and does not wait for the answer. The shell waits for the engine only when you press Tab or Enter to insert a row, for 300 ms at most. Outside tmux, zsh also waits at the start of a word while the terminal reports the cursor position. A terminal answers in a few milliseconds; zsh waits at most 1 second for a slow one. ### No permission prompts No Screen Recording access. In a window or tab, tmux or the terminal app gives the cursor position. A native split (Cmd+D) and the terminal of VS Code or Cursor need Accessibility, so Figxit can read where the pane is. Figxit asks the first time you type in one. The terminal of Zed needs no Accessibility: an experimental setting asks Zed for its text cursor position. ## Keys | Key | Action | |---|---| | Up, Down | Move the highlight. The first row is highlighted when you typed part of it, or when your history has it for this command. If no row is highlighted, the first Down highlights the first row | | Tab | Insert the highlighted row. When no row is highlighted, insert the first row | | Enter | On a highlighted row: insert it and run the line. A row with a red icon is inserted and not run. On the run row (the return icon, shown first when the typed word is complete): run the line. When no row is highlighted, run the line as typed. To make Enter insert the row and not run the line, turn off "Enter runs the highlighted row" in Settings (menu bar icon, then Settings) | | Esc | Close the list. In zsh vi mode, the same press also goes to command mode | | Ctrl-U or more typing | Close the list | When the popup is closed, the keys do what they did before. Tab still opens your normal completion and Up still searches your history. ## How it works Figxit has three parts that talk over unix sockets in `~/.local/state/figxit/`. The line you type is not sent over the network. 1. **Adapter** (zsh, bash, fish). A line editor hook in the shell sends the buffer, the cursor, and the folder to the engine after each key and returns at once. 2. **Engine** (Bun). It keeps your history and the loaded specs in memory. For each key it parses the line, collects candidates from the project files, the spec, and your history, then merges and ranks them and sends the visible rows to the helper. Values that need a command (git branches, for example) arrive in a second pass, so the first rows are never delayed. 3. **Helper** (Swift, AppKit). A macOS app with no Dock icon. It starts the engine and restarts it after a crash. It shows the floating panel and hides it when you switch app, window, or tab. ## Install One app contains the engine and the completion specs. There is nothing else to install. 1. Download [Figxit.dmg](https://figxit.com/download/Figxit.dmg), open it, and drag Figxit to Applications. 2. Open Figxit. An icon appears in the menu bar and a setup window opens. It lists the shells on your Mac. Click **Set Up** for your shell, or add the line yourself. This is the line for zsh. Use `init bash` for bash. For fish, put `status is-interactive; and '/Applications/Figxit.app/Contents/MacOS/figxit-engine' init fish | source` in `~/.config/fish/conf.d/figxit.fish`. ```bash eval "$('/Applications/Figxit.app/Contents/MacOS/figxit-engine' init zsh)" ``` 3. Open a new terminal and type a command. To check the installation, run this: ```bash figxit doctor ``` The `eval` line also defines the `figxit` command in your shell, so nothing needs to be on your PATH. To build from source, see the [README](https://github.com/en3sis/figxit#development). ## The figxit command | Command | Action | |---|---| | `figxit init zsh` | Print the lines that load Figxit in zsh. Also `init bash` and `init fish` | | `figxit start` | Start the popup helper and the engine | | `figxit stop` | Stop them | | `figxit doctor` | Check each part of the installation | | `figxit --version` | Print the version | ## Requirements - A Mac with Apple Silicon. - macOS 13 or later. The glass background needs macOS 26 or later. - zsh, bash 5 or later, or fish 4. The `/bin/bash` of macOS is version 3.2 and does not work. - tmux is optional, and herdr panes work too. Without tmux or herdr, the terminal app must report its cursor position. Tested in Ghostty, iTerm2, and Terminal. WezTerm, Alacritty, and kitty are not tested yet without tmux. - Atuin, optional, for ranking. - No Screen Recording permission is needed. Accessibility is needed only for a native split of the terminal app and for the terminal of VS Code and Cursor. - Editors: the terminal panel of VS Code and Cursor, with Accessibility. The terminal of Zed is experimental: turn on Settings > Experimental > Zed terminal, then reopen Zed. The setting adds a hidden input method that asks Zed where its text cursor is. It does not read what you type and does not change the keyboard layout. Tested in Zed 1.27 on macOS 27. JetBrains IDEs are not tested yet. ## Limits - Without Accessibility, a native split of the terminal app and the terminal of VS Code or Cursor get no popup. The terminal of Zed gets no popup unless the experimental Zed terminal setting is on. - bash and fish: the popup is off in vi mode. - macOS only. - zsh and bash: Escape as a prefix for a Meta key (Escape, then `b`) works only when the second key follows within the key timeout of the shell, 0.4 seconds in zsh and 0.5 seconds in bash. - After an option that ends in `=`, values are not suggested yet. - Spec generators that search the network on each key are turned off. - Generators that need a live service, for example `kubectl get`, show nothing when the service does not answer in 1.5 seconds. ## FAQ ### Is Figxit a replacement for Fig? Yes, for Fig's autocomplete: the list that opens as you type, with a description on each row. Figxit loads the same open source completion specs that Fig used. It does not have the other Fig features, such as scripts, dotfile sync, and team sharing, and it has no AI chat. ### Can I use it in place of Amazon Q or Kiro CLI autocomplete? Yes, if you only want the autocomplete. Figxit needs no account and has no AI features. It is not affiliated with Fig, Amazon, or Kiro. ### Is Figxit a replacement for Microsoft inshellisense? On a Mac with zsh, bash, or fish, yes. Both use the Fig completion specs. inshellisense draws its list inside the terminal session. Figxit shows its list in a native macOS window and orders it by your history. inshellisense also runs on Windows and Linux and in other shells, and Figxit does not. ### Which commands does it know? The Fig completion specs cover more than 700 tools, for example git, docker, npm, and kubectl. Figxit also reads the Makefile targets and package.json scripts in the current folder. ### Does Figxit send what I type anywhere? No. It has no telemetry and no account. Its only network request is the update check, one time each day, and you can turn that off in Settings. ### Do I need tmux? No. Figxit works in tmux and directly in Ghostty, iTerm2, and Terminal. A native split of the terminal app (Cmd+D) needs the Accessibility permission. ### Is it free? Yes. Figxit is open source under the MIT licence. ## Guides - zsh autocomplete: https://figxit.com/zsh-autocomplete.html - bash autocomplete: https://figxit.com/bash-autocomplete.html - fish autocomplete: https://figxit.com/fish-autocomplete.html - Autocomplete in tmux: https://figxit.com/tmux-autocomplete.html - Autocomplete in IDE terminals (VS Code, Cursor, Zed): https://figxit.com/ide-terminal-autocomplete.html - VS Code and Cursor terminal: https://figxit.com/vscode-terminal-autocomplete.html - Fig alternative: https://figxit.com/fig-alternative.html ## Privacy Figxit has no telemetry: the app does not report what you type, what you run, or how you use it. Its only network request is the update check, one time each day, which reads one file from figxit.com. Those checks are counted by app version, and downloads of the app are counted. The count holds the version and the date, with no IP address and no identifier. To stop the check, turn off **Check for updates automatically** in Settings. Figxit reads your history database and the files in the current folder. Completion specs can run local commands to list values, for example `git branch`. They do not run when the line contains quotes, `$`, or other shell syntax. Words from your history that look like a secret are not shown: a value after `--token` or `--password`, an assignment such as `API_KEY=...`, and long random strings. This filter cannot find all secrets, for example a password written directly after `-p`. ## Credits - Completion specs: [withfig/autocomplete](https://github.com/withfig/autocomplete), MIT licence. - Product icons: [Simple Icons](https://simpleicons.org), CC0 licence. The logos are trademarks of their owners. - Interface icons on the website: [Lucide](https://lucide.dev), ISC licence. - Updates: [Sparkle](https://sparkle-project.org), MIT licence. - Figxit is not affiliated with Fig, Amazon, or Kiro. - Built by [en3sis](https://en3sis.com). ## Licence MIT. Source and issues: https://github.com/en3sis/figxit