@@ -28,12 +28,37 @@ dnx go -- app.cs
2828
2929# Pass arguments to your app
3030dnx go -- app.cs arg1 arg2
31+
32+ # Re-run a previous app from interactive history (no path/ref required)
33+ dnx go
3134```
3235
3336The default mode publishes the app with native AOT and then runs the resulting executable,
3437with smart up-to-date checks of every C# file used to build the app (including
3538` #include ` and ` #ref ` directives, transitively).
3639
40+ ### Run history (MRU)
41+
42+ Every successful ` go ` / ` go dev ` invocation records the entry point (local full path or
43+ remote ref) in a shared history file next to the cache root (` dotnet/go/go.toml ` ).
44+
45+ With at least one history entry, running with ** no arguments** in an interactive
46+ terminal opens a searchable picker (ordered by use count then recency). After you
47+ pick an entry you can optionally type app arguments (quoted groups supported).
48+ With an empty history, or when stdin is redirected / non-interactive (CI, pipes),
49+ ` dnx go ` with no args shows help instead of erroring.
50+
51+ Local paths that no longer exist are dropped from the picker; remote refs stay listed
52+ even when their download bundle is gone (the next run re-downloads as usual).
53+
54+ ``` console
55+ # Interactive: pick a previous run, then optional args
56+ dnx go
57+
58+ # Same as always — also bumps that entry in history
59+ dnx go -- app.cs
60+ dnx go -- kzu/sandbox
61+ ```
3762Native AOT needs a platform C/C++ linker (VC++ build tools on Windows, ` build-essential ` on
3863Ubuntu, Xcode Command Line Tools on macOS). Verify with:
3964
@@ -127,9 +152,23 @@ dnx go -- clean owner/repo[@ref][:path]
127152dnx go -- clean --all
128153```
129154
155+ ` clean ` only removes build/publish/download artifacts. Run history is left intact
156+ so the MRU picker still lists those apps (a later run simply rebuilds or re-downloads).
157+
158+ To drop history as well, use ` remove ` :
159+
160+ ``` console
161+ # Clean artifacts and remove this entry from MRU history
162+ dnx go -- remove app.cs
163+ dnx go -- remove owner/repo[@ref][:path]
164+
165+ # Wipe all cached apps and clear the entire MRU history
166+ dnx go -- remove --all
167+ ```
168+
130169Unused download locations and published binaries are periodically cleaned up
131170in a detached background process. Apps you run regularly are never affected.
132-
171+ Automatic cleanup updates ` lastCleanupUtc ` in ` go.toml ` but does not clear history.
133172## Agent skill
134173
135174` go# ` ships a bundled [ agent skill] ( skills/go-sharp/SKILL.md ) that teaches coding
0 commit comments