一个带有语法高亮的命令行 C# REPL - 以交互方式探索语言、库和 NuGet 包。
To run ASP.NET applications inside the REPL, start the `csharprepl ` application with the `--framework` parameter, specifying the `Microsoft.AspNetCore.App` shared framework. Then, use the above `#r` command to reference the application DLL. See [Configuring CSharpRepl](https://github.com/waf/CSharpRepl/wiki/Configuring-CSharpRepl) for more details. ```console csharprepl --framework Microsoft.AspNetCore.App ``` ## Loading scripts Use the `#load` directive to run a C# script file (`.csx`), e.g. `#load "path/to/script.csx"`. This is handy for initializing a session, as any references, namespaces, and variables the script defines remain available afterwards. ## Connecting to a running process In addition to the normal REPL, which evaluates code in csharprepl's own process, csharprepl can attach to other .NET applications and evaluate expressions inside them, reading and writing live application state (e.g. statics and services resolved from DI). > [!WARNING] > Connecting to a connector-enabled process is **equivalent to running arbitrary code inside it, with its privileges**. This is a development and diagnostics tool; never enable the connector on a production process. CSharpRepl injects a real Roslyn scripting engine into the target application, so you can run unconstrained C# in that application. This is not a debugger; breakpoints, stepping, and non-cooperative attach are not supported. The target's source does not need to be modified, but the application must "opt in" by running from a shell with two special environment variables that allow CSharpRepl to inject the REPL: 1. Print the environment variables to launch your app with: ```console csharprepl connect init # this autodetects your shell, or pass e.g. --shell pwsh ``` 2. Set the environment variables from the previous step, and launch your app in that shell. You should NOT set these as permanent environment variables on your machine. Only set them in the shell where you plan to launch the target application. 3. Attach to the application by its process ID: ```console csharprepl connect list # lists available processes to attach to, with their process ID. csharprepl connect 1234 # attaches to a process with process ID e.g. 1234 ``` This will start the REPL in the target application. Some things you can try: - Statics: reference them by their fully-qualified name, e.g. `MyApp.Program.SomeStatic` (read and write). - DI services (ASP.NET Core or Generic Host apps): `services.GetRequiredService()` or the shorthand `Get()`. The connector captures the application's root service provider via .NET's hosting hooks. Type `exit` (or press Ctrl+D) to detach. The target application will keep running, and you can reconnect to it later. ### Modifying a running process While connected to a process, you can also replace live methods in that process. Define a method matching the target's signature. Instance methods take the instance as the first parameter: ```csharp > decimal half(MyApp.OrderService svc, int qty, decimal unit) => qty * unit * 0.5m; ``` Then run the following (with the fully qualified target method name) to replace the original method: ```csharp #replace MyApp.OrderService.CalculatePrice with half ``` To wrap a method instead of replacing it, define a method whose first parameter is an `orig` delegate that calls the original: ```csharp > decimal logged(Func orig, MyApp.OrderService svc, int qty, decimal unit) { var price = orig(svc, qty, unit); Console.WriteLine($"CalculatePrice({qty}, {unit}) = {price}"); return price; } > #wrap MyApp.OrderService.CalculatePrice with logged ``` To undo a modification, use `#patches` to list active patches and `#revert ` or `#revert all` to undo them. Patches take effect immediately and persist in the target until reverted or the process exits. Patching is done via the excellent [MonoMod](https://github.com/monomod/monomod) library **Requirements and limitations:** - `net10.0` targets only. The connector and the target must both be on .NET 10. - Apps published as single-files have very limited functionality: - A framework-dependent single-file app's assemblies are bundled with no metadata, so strongly-typed access to the app's own types is unavailable. You need to use reflection to access the app's types. - A self-contained single-file app is unsupported (even the runtime is bundled, so nothing can be compiled). The connector will refuse to start. - Method replacement is not supported for generic methods, pointer parameters, and methods the JIT already inlined at a call site. See the [Injected Hook documentation](https://github.com/waf/CSharpRepl/blob/main/InjectedHook/InjectedHookReadme.md) for information on how this works under the hood. ## AI Code Completion C# REPL can suggest completions using an AI model. Press Ctrl+Alt+Space at the caret to request a completion; the generated code streams directly into the prompt at the caret as it arrives. Suggestions are generated from the code you've typed in the current session, so they're aware of the variables, methods, and types you've already defined.
This works with OpenAI, Anthropic, Gemini, Grok, DeepSeek, Mistral/Codestral, or any other OpenAI-compatible provider (bring your own API key). Use the `--aiProvider` option and related settings to choose and/or configure a provider; see [Configuring CSharpRepl](https://github.com/waf/CSharpRepl/wiki/Configuring-CSharpRepl) for details. ## Keyboard Shortcuts CSharpRepl aims for a similar editing experience as Visual Studio (e.g. for text navigation, selection and keyboard shortcuts). - **Basic Usage** - Ctrl+C - Cancel current line (or copies text if text is highlighted) - Ctrl+D or type `exit` - Exit the REPL - Ctrl+L or type `clear` - Clear screen - Enter - Evaluate the current line if it's a syntactically complete statement; otherwise add a newline - Ctrl+Enter or Ctrl+Alt+Enter - Evaluate the current line, and return a more detailed representation of the result - Shift+Enter or Alt+Enter - Insert a new line without evaluating - Ctrl+Z / Ctrl+Y - Undo / redo - Ctrl+Alt+Space - Request an AI code completion at the caret (requires an AI provider API key to be configured; OpenAI by default, see `--aiProvider`) - **Editing & Clipboard** - Ctrl+Shift+C - Copy the entire current input to the clipboard - Ctrl+X - Cut the highlighted text, or the current line if nothing is highlighted - Shift+Delete - Cut the current line - Ctrl+V, Shift+Insert, and Ctrl+Shift+V - Paste text to prompt. Automatically trims leading indent - Ctrl+A - Select all - Ctrl+Backspace / Ctrl+Delete - Delete the word to the left / right of the caret - Ctr
Nested references inside #load inside a .csx file don't resolve
Intellisense failure with multi-line code blocks
Remote Console For Web Applications
Unable to use the new extension members
Add an Option to hide the welcome notice
File completion
Show result of last statement
Trying to use it in Godot Engine and some feature requests
Make a C# repl for your project in 2 minutes
How to use as a replacement for the C# Interactive tool in JetBrains Rider?