Skip to content

Commit 4d00124

Browse files
devlooped-botkzu
authored andcommitted
+Mᐁ includes
1 parent aa73a4d commit 4d00124

1 file changed

Lines changed: 40 additions & 1 deletion

File tree

src/go/readme.md

Lines changed: 40 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,12 +28,37 @@ 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** 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+
```
3762
Native AOT needs a platform C/C++ linker (VC++ build tools on Windows, `build-essential` on
3863
Ubuntu, Xcode Command Line Tools on macOS). Verify with:
3964

@@ -127,9 +152,23 @@ dnx go -- clean owner/repo[@ref][:path]
127152
dnx 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+
130169
Unused download locations and published binaries are periodically cleaned up
131170
in 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

Comments
 (0)