CHEST System Reference

$ go install github.com/Aswanidev-vs/chest/cmd/chest@latest

$ curl -sSL https://raw.githubusercontent.com/Aswanidev-vs/chest/main/install.sh | bash

> irm https://raw.githubusercontent.com/Aswanidev-vs/chest/main/install.ps1 | iex

$ git clone https://github.com/Aswanidev-vs/chest.git
$ cd chest
$ make build

$ chest sort ~/Downloads -p downloads --dry-run

$ chest sort ~/Downloads -p downloads

$ chest undo

$ chest search "movie"             # Fuzzy filename search (default mode)
$ chest search --type video --size ">1GB"  # Combine category + size filters
$ chest search -e pdf,docx -m "<30d" ~/Documents
$ chest search -c "TODO" internal/   # Grep inside files, with line numbers
$ chest search -e go,md -i chest -j  # JSON output for scripting

$ chest watch ~/Downloads --preset media --debounce 500ms
$ chest watch ~/Desktop --initial  # Sort existing files first, then watch

$ chest history        # Display recorded operation history
$ chest undo           # Undo the most recent run
$ chest undo 4         # Undo specific transaction by ID

$ chest index ~/Documents --hash    # Incremental parallel SHA-256 with progress bar
$ chest clean                       # Prune deleted files from local index
$ chest clean --all                 # Reset index database completely
$ chest clean --history           # Also wipe undo history (~/.chest/history.json)

$ chest stats ~/Projects            # Category and size breakdown
$ chest duplicates ~/Downloads      # Locate byte-for-byte duplicates
$ chest duplicates ~/Projects --except node_modules,venv # Skip noisy dirs
$ chest analyze ~/Documents         # Find zero-byte files and stale items (>180 days); footer shows total run time

$ chest man sort       # View built-in Unix man page for command
$ chest preset         # List all built-in rulesets
$ chest version        # Print binary version, commit, and platform

$ chest completion --install      # Detect your shell, install, and wire it up (recommended)
$ chest completion zsh --install   # Install zsh completion permanently
$ chest completion fish --install  # Install fish completion permanently
$ chest completion bash > _chest # Print the raw script to stdout instead

$ mkdir chest-custom-plugin
$ cd chest-custom-plugin
$ go mod init chest-custom-plugin

package main

import (
    "strings"
    hplugin "github.com/hashicorp/go-plugin"
    "github.com/Aswanidev-vs/chest/internal/plugin"
)

type CustomClassifier struct{}

func (c *CustomClassifier) GetInfo() (plugin.Manifest, error) {
    return plugin.Manifest{
        Name:         "custom-filter",
        Version:      "1.0.0",
        Description:  "Classifies custom test files",
        Capabilities: []string{"classifier"},
        Binary:       "custom-filter",
    }, nil
}

func (c *CustomClassifier) Classify(name string, ext string) (string, error) {
    if strings.HasSuffix(name, ".spec.ts") {
        return "UnitTests", nil
    }
    return "Other", nil
}

func main() {
    hplugin.Serve(&hplugin.ServeConfig{
        HandshakeConfig: plugin.HandshakeConfig,
        Plugins: map[string]hplugin.Plugin{
            "classifier": &plugin.ClassifierPluginRPC{Impl: &CustomClassifier{}},
        },
    })
}

{
  "name": "custom-filter",
  "version": "1.0.0",
  "description": "Classifies custom test files",
  "author": "Developer",
  "capabilities": ["classifier"],
  "binary": "custom-filter"
}

name          = "custom-filter"
version       = "1.0.0"
description   = "Classifies custom test files"
author        = "Developer"
capabilities  = ["classifier"]
binary        = "custom-filter"

$ go build -o custom-filter .
$ chest plugin install .

$ chest plugin install .      # Install plugin from local folder
$ chest plugin list           # List installed plugins
$ chest plugin info <name>    # View plugin metadata
$ chest plugin remove <name>  # Uninstall a plugin