Rosia CLI

Reclaim disk space from development dependencies and caches

Rosia is a universal, fast, and secure command-line tool that helps developers reclaim disk space by cleaning dependencies, builds, and caches across multiple project types. Whether you’re working with Node.js, Python, Rust, Flutter, or Go projects, Rosia intelligently detects and safely removes cleanable artifacts.

Key Features

Quick Start

Install Rosia:

# Homebrew (macOS/Linux)
brew install rosia

# Scoop (Windows)
scoop install rosia

# Go Install
go install github.com/raucheacho/rosia-cli@latest

Scan and clean your projects:

# Scan current directory
rosia scan .

# Launch interactive TUI
rosia ui .

# Clean with confirmation
rosia clean

Why Rosia?

Development projects accumulate gigabytes of dependencies, build artifacts, and caches over time. Manually finding and cleaning these files across different project types is tedious and error-prone. Rosia automates this process with:

Get Started

Ready to reclaim your disk space? Check out the Getting Started guide to install and configure Rosia for your workflow.

Community & Support

Made with ❤️ by developers, for developers.

Commands

Commands Reference

Complete guide to all Rosia CLI commands and their options.

Global Flags

These flags work with all commands:

  • --verbose, -v - Enable verbose logging
  • --config, -c <path> - Specify custom config file path
  • --help, -h - Show help for any command

rosia scan

Scan directories to identify cleanable targets.

Usage

rosia scan [paths...] [flags]

Examples

# Scan current directory
rosia scan .

# Scan multiple directories
rosia scan ~/projects ~/workspace

# Scan with depth limit
rosia scan . --depth 5

# Include hidden directories
rosia scan . --include-hidden

# Dry-run (preview without changes)
rosia scan . --dry-run

# Verbose output
rosia scan . --verbose

Flags

FlagShortTypeDefaultDescription
--depth-dintunlimitedMaximum directory depth to scan
--include-hiddenboolfalseInclude hidden directories in scan
--dry-runboolfalseShow what would be cleaned without making changes

Output

The scan command displays a table of detected targets:

By raucheacho

read more

Configuration

Configuration

Rosia uses a JSON configuration file to customize its behavior. This guide covers all configuration options and how to manage them.

Configuration File

The configuration file is located at ~/.rosiarc.json. If it doesn’t exist, Rosia uses default settings.

Default Configuration

{
  "trash_retention_days": 3,
  "profiles": ["node", "python", "rust", "flutter", "go"],
  "ignore_paths": [],
  "plugins": [],
  "concurrency": 0,
  "telemetry_enabled": false
}

Configuration Options

trash_retention_days

Type: integer
Default: 3
Description: Number of days to keep items in trash before automatic cleanup.

By raucheacho

read more

FAQ

Frequently Asked Questions

General

What is Rosia?

Rosia is a command-line tool that helps developers reclaim disk space by cleaning dependencies, builds, and caches across multiple project types. It supports Node.js, Python, Rust, Flutter, Go, and more.

Is Rosia safe to use?

Yes! Rosia includes several safety features:

  • Confirmation prompts before deletion
  • Trash system for recovery
  • Permission checks before deletion
  • Dry-run mode to preview changes

How much disk space can I save?

It depends on your projects, but users typically save:

By raucheacho

read more

Getting Started

Getting Started

This guide will help you install Rosia and get started cleaning your development projects.

Installation

Homebrew (macOS/Linux)

The easiest way to install Rosia on macOS or Linux:

brew install rosia

Scoop (Windows)

For Windows users with Scoop:

scoop install rosia

Go Install

If you have Go installed:

go install github.com/raucheacho/rosia-cli@latest

Manual Installation

Download the latest binary from the releases page.

Linux/macOS:

curl -L https://github.com/raucheacho/rosia-cli/releases/latest/download/rosia_$(uname -s)_$(uname -m).tar.gz | tar xz
sudo mv rosia /usr/local/bin/

Windows (PowerShell):

By raucheacho

read more

Plugins

Plugins

Rosia’s plugin system allows you to extend its functionality with custom cleaning logic for technologies and tools not covered by built-in profiles.

Overview

Plugins enable you to:

  • Add support for new technologies (Docker, Xcode, Android, etc.)
  • Implement custom scanning logic
  • Create specialized cleaning workflows
  • Integrate with external tools

Plugin Types

Rosia supports two types of plugins:

  1. Go Plugins - Native Go plugins using Go’s plugin system
  2. JSON-RPC Plugins - External executables communicating via JSON-RPC (any language)

Using Plugins

Installing Plugins

  1. Download or build the plugin
  2. Place it in ~/.rosia/plugins/
  3. Enable it in your configuration
# Create plugins directory
mkdir -p ~/.rosia/plugins

# Copy plugin
cp rosia-docker.so ~/.rosia/plugins/

# Enable plugin
rosia config set plugins rosia-docker

Listing Plugins

View all loaded plugins:

By raucheacho

read more