🔥 FsiX 🔥

A better REPL for F# with project/solution support and hot reloading.
Brings REPL driven development to F#!

📹 Demo

cutcutcut.mp4

---

✨ Features

• Project & Solution Support (*.fsproj / *.sln)
  No need to manually reference DLLs or NuGets.
  FsiX automatically detects your project structure and loads everything for you.

• Hot Reloading

  Redefine a function with the same name, type signature, and (optionally) module path —
  FsiX will patch the original assembly so all calls use the new version instantly.

• Inline Async & Computation Expressions

  Write code like:

  let! result = someAsyncCall

  and FsiX rewrites it into:

  let result = someAsyncCall |> _.Run()
  

  Perfect for step-by-step debugging of async and other computation expressions.

• File imports with #open

  Example:

  :open FileName.fs
  

  Opens the top-level module in MyFile.fs and any modules it depends on. Useful when working inside a specific file.

• Shorter Directives

  • #q instead of #quit.

  • :q, :help, and other : alternatives for directives.

    Use your vim muscle memory in F#!

• Smarter Interactive Help

  • #help now tries to accurately resolve the overload of the input expression.

  • A new directive, #htype, provides the documentation of a type, instead of its constructor.

• Modern REPL Experience

  Autocompletion, history, syntax highlighting, and more niceties via PrettyPrompt

🚀 Installation

If your project uses regular .NET SDK:

dotnet tool install --global fsix

Or, if it uses Asp net core sdk:

dotnet tool install --global fsix.web

Then, just run

fsix #or fsix-web

in the root dir of your project

🛠 Configuration

There is configuration file in ~/.config/fsix/repl.fsx if you are on GNU/Linux and %appdata%\fsix\repl.fsx if you are on windows. It's basically just an F# script which is being run on repl start, which has to contain replConfig object with prompt configuration. FsiX will also load on start .repl.fsix file if it's present in current dir.

📌 Future features

• Integration with Conjure
• (Maybe) n-repl support
• Ability to add REPL to any of your projects just as library

🤝 Contributing

Contributions are welcome! Feel free to open issues or PRs.