Skip to content

Commit fc5a1c8

Browse files
committed
+Mᐁ includes
1 parent 662e977 commit fc5a1c8

1 file changed

Lines changed: 39 additions & 1 deletion

File tree

src/go/readme.md

Lines changed: 39 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,12 +28,36 @@ dnx go -- app.cs
2828

2929
# Pass arguments to your app
3030
dnx go -- app.cs arg1 arg2
31+
32+
# Re-run a previous app from interactive history (no path/ref required)
33+
dnx go
3134
```
3235

3336
The default mode publishes the app with native AOT and then runs the resulting executable,
3437
with 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** opens an interactive
46+
picker (searchable, ordered by use count then recency). After you pick an entry you
47+
can optionally type app arguments (quoted groups supported). With an empty history,
48+
`dnx go` with no args shows help instead.
49+
50+
Local paths that no longer exist are dropped from the picker; remote refs stay listed
51+
even when their download bundle is gone (the next run re-downloads as usual).
52+
53+
```console
54+
# Interactive: pick a previous run, then optional args
55+
dnx go
56+
57+
# Same as always — also bumps that entry in history
58+
dnx go -- app.cs
59+
dnx go -- kzu/sandbox
60+
```
3761
Native AOT needs a platform C/C++ linker (VC++ build tools on Windows, `build-essential` on
3862
Ubuntu, Xcode Command Line Tools on macOS). Verify with:
3963

@@ -127,9 +151,23 @@ dnx go -- clean owner/repo[@ref][:path]
127151
dnx go -- clean --all
128152
```
129153

154+
`clean` only removes build/publish/download artifacts. Run history is left intact
155+
so the MRU picker still lists those apps (a later run simply rebuilds or re-downloads).
156+
157+
To drop history as well, use `remove`:
158+
159+
```console
160+
# Clean artifacts and remove this entry from MRU history
161+
dnx go -- remove app.cs
162+
dnx go -- remove owner/repo[@ref][:path]
163+
164+
# Wipe all cached apps and clear the entire MRU history
165+
dnx go -- remove --all
166+
```
167+
130168
Unused download locations and published binaries are periodically cleaned up
131169
in a detached background process. Apps you run regularly are never affected.
132-
170+
Automatic cleanup updates `lastCleanupUtc` in `go.toml` but does not clear history.
133171
## Agent skill
134172

135173
`go#` ships a bundled [agent skill](skills/go-sharp/SKILL.md) that teaches coding

0 commit comments

Comments
 (0)