Amafu 4.5.17

There is a newer version of this package available.
See the version list below for details.
dotnet tool install --global Amafu --version 4.5.17
                    
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
                    
if you are setting up this repo
dotnet tool install --local Amafu --version 4.5.17
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=Amafu&version=4.5.17
                    
nuke :add-package Amafu --version 4.5.17
                    

Amafu (amafu)

Amafu finds locally synchronized cloud-storage roots and writes the shared ~/.config/RAIkeep.json5 configuration used by RAIkeep command-line tools. It can also create stable shortcuts under ~/.CloudStorage/, avoiding vendor-managed macOS paths such as ~/Library/CloudStorage/GoogleDrive-…/My Drive/.

Cloud detection is supported on macOS and Linux. Commands do not move cloud data.

Amafu v4.5.17

Read configuration paths, provider order, and observer targets with the new list selectors. Named lookups print a single value; collection views use the shared provider badges and colors. Each selector has its own help screen. The native binary remains independent of a .NET runtime.

Latest release notes: Amafu 4.5.17 release notes.

Previous Versions

For release notes and changelogs of earlier releases, see the Amafu 4.x Release Notes.

Installation

The installer handles Amafu only. Pass the release number explicitly so the installed command is reproducible.

Native binary, without .NET

Installs the matching macOS or Linux native release binary in /usr/local/bin. It requires curl, unzip, and administrator permission.

curl -fsSL https://raw.githubusercontent.com/Burkhardt/RAIkeep/main/scripts/InstallAmafu.sh | sudo bash -s -- native 4.5.17

.NET global tool

Installs the Amafu tool for the current user in the normal .NET global-tools location. Use this when that directory is already on your PATH.

curl -fsSL https://raw.githubusercontent.com/Burkhardt/RAIkeep/main/scripts/InstallAmafu.sh | bash -s -- global 4.5.17

.NET tool in /usr/local/bin

Installs the Amafu tool in /usr/local/bin, avoiding a per-user tool directory on PATH. It requires .NET and administrator permission.

curl -fsSL https://raw.githubusercontent.com/Burkhardt/RAIkeep/main/scripts/InstallAmafu.sh | sudo bash -s -- system 4.5.17

Do not run amafu itself with sudo; it should use the ordinary user's cloud folders and configuration.

Commands

detect

Inspect the cloud roots Amafu finds without changing the machine:

amafu detect

On Ubuntu, preview the mounted roots as JSON without writing anything:

amafu detect --json --dry-run

Use --json when another program needs the result. With more than one personal OneDrive root, select one deterministically for this run:

amafu detect --onedrive-personal 'OneDrive-Personal(2)' --json

list

Read selected settings from the current user's ~/.config/RAIkeep.json5:

amafu list temp
amafu list backup
amafu list order all
amafu list cloud all
amafu list observer all

Named lookups print just a value and a newline, without colors or labels:

amafu list cloud OneDrive
amafu list order OneDrive
amafu list observer Mzansi

Paths are absolute with ~ expanded and a trailing directory separator. Order positions start at 1; a provider absent from DefaultCloudOrder returns 0, even if it has a configured cloud path. Observer lookups return the configured SSH target without connecting to it.

Collection output uses the shared provider glyphs and colors. Cloud tables use the provider glyph and name at the left margin, followed by a newline and one tab before the double-quoted path. Observer tables use space-aligned columns. Redirected output and NO_COLOR disable ANSI colors; scalar output is always undecorated.

Use selector-specific help, for example amafu list order -h. The top-level amafu list all is rejected. Queries do not create directories, change the configuration, probe providers, or connect to observers. A missing or malformed configuration produces an error; use amafu init to create an initial file.

init

For a new machine, create clean shortcuts and the initial configuration:

amafu init --create-links

Preview the exact result first with --dry-run. init preserves an existing configuration unless --force is supplied.

reconcile

For an existing configuration, preview additional detected roots and any move to shortcut paths:

amafu reconcile

Apply the preview only after review:

amafu reconcile --apply

Amafu creates a backup before changing an existing configuration. It does not move or delete provider data.

Terminal Font

The amafu help screen uses Nerd Font glyphs. The tested choice for Blink on iPadOS is the JetBrains Mono Nerd Font stylesheet. The terminal font guide also covers macOS and Ubuntu.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
4.6.7 13 11/19/2026
4.6.6 60 11/19/2026
4.6.5 102 11/16/2026
4.6.4 112 11/16/2026
4.6.3 96 11/7/2026
4.6.2 103 11/7/2026
4.6.1 111 11/5/2026
4.6.0 108 11/5/2026
4.5.18 105 11/3/2026
4.5.17 115 11/3/2026
4.5.16 104 11/3/2026
4.5.15 132 10/30/2026
4.5.14 118 10/26/2026
4.5.13 109 10/20/2026
4.5.12 124 10/19/2026
4.5.11 107 10/19/2026
4.5.10 119 10/12/2026
4.5.9 105 10/12/2026
4.5.8 110 10/10/2026
4.5.7 107 10/10/2026
Loading failed

Read-only configuration selectors, provider collections, clean scalar values, and contextual help (CR076).