Auge

Observe... and reshape the visual world line.

Auge is a command-line artifact forged in the fires of Rust, designed to manipulate the fabric of visual perception. It serves not merely as a tool, but as an extension of the user's will, seamlessly integrating into the data streams of Unix-style pipelines to chain alterations to reality itself.

Whether you seek to blur the edges of existence, drain the chromatic essence from an image, or reconstruct it through the lens of pointillism, Auge stands ready. It can even project the results directly into your ocular interface (terminal), detecting advanced protocols like iTerm or Kitty, or falling back to primitive block representations if necessary.

The Ritual of Summoning

To manifest this apparatus within your local environment, you may acquire pre-compiled instances for Windows (x86_64) and Linux (x86_64, aarch64) from the release zone.

Alternatively, those proficient in the ways of cargo may compile it from the source ether:

# Initiate synchronization sequence
cargo install auge

# OR forge directly from the source repository
# cargo install --git https://github.com/metdxt/auge

Invocation

Once materialized, the apparatus responds to the following incantations:

auge [OPTIONS] <COMMAND>

Consult the internal knowledge base via auge --help or auge <COMMAND> --help to uncover the deeper secrets of each operation.

The Grimoire (Capabilities)

Auge possesses a vast array of "Reality Alteration Protocols" (filters) to modify input data:

Advanced Manipulation

• Stream Chaining: Auge thrives in the flow. It reads from stdin and writes to stdout, allowing you to chain multiple instances to perform complex rituals.
• Ocular Projection: If no output file is specified and the destination is a terminal, Auge automatically attempts to render the image directly to your view.

Known Realms (Supported Formats)

The apparatus can decipher and encode a multitude of visual formats across the multiverse:

Demonstrations of Power

Scenario I: The Chromatic Shift Transform a PNG into a grayscale artifact, blur its essence, and seal it into a new vessel.

auge -i input.png grayscale | auge g-blur -s 3 > output.png

Scenario II: The Pointillist Vision Gaze upon an image directly in your terminal, reconstructed as dot art with a custom background.

auge -i input.jpg dotart --bg-color "#1a1a1a" --scale 12

Scenario III: Detecting Anomalies Identify red blobs in the visual field and visualize them as a heatmap.

auge -i input.png blob-detect --color "#FF0000" --threshold 30 --mode heatmap

The Covenant

This apparatus is distributed under the MIT License. You are free to use, modify, and distribute it across the timelines, provided the ancient texts (license headers) remain intact.