MCPcopy Index your code
hub / github.com/Vanilla-OS/vanilla-system-operator

github.com/Vanilla-OS/vanilla-system-operator @v3.1.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v3.1.0 ↗ · + Follow
128 symbols 281 edges 11 files 67 documented · 52% updated 6d agov3.1.0 · 2026-07-01★ 389 open issues
What it actually does AI analysis from the code graph — generated when you open this
loading…
README


Vanilla System Operator

Translation Status

VSO is a utility which allows you to perform maintenance tasks on your Vanilla OS installation.

Help

The Vanilla System Operator is a package manager, a system updater and a task automator.

Usage:
  vso [command]

Available Commands:
  android     Manage the vso waydroid subsystem
  completion  Generate the autocompletion script for the specified shell
  config      Manage the system configuration.
  export      Export an application or binary from the subsystem
  help        Help about any command
  install     Install an application inside the subsystem
  pico-init   Initialize the VSO subsystem, used for package management
  remove      Remove an application from the subsystem
  run         Run an application from the subsystem
  search      Search for an application to install inside the subsystem
  shell       Enter the subsystem environment
  sideload    Sideload DEB/APK packages inside the subsystem
  sys         Execute system commands, such as upgrading the system
  tasks       Create and manage tasks
  unexport    Unexport an application or binary from the subsystem
  update      Update the subsystem's package repository
  upgrade     Upgrade the packages inside the subsystem

Flags:
  -h, --help      Show help for vso.
  -v, --version   Show version for vso.

Use "vso [command] --help" for more information about a command.

Documentation

The official documentation and manpage for vso are available at https://docs.vanillaos.org/docs/en/vso.

VSO as system Shell

To use VSO as your system shell, you can copy the usr/bin/vso-os-shell script to your system's /usr/bin directory and set it as your default shell. Your image needs to implement the usr/bin/os-shell script, which will expand the $SHELL environment variable, this is much needed for login shells and other flags, this also ensures that the user's default shell is respected.

Our vso-image already implements this script.

Core symbols most depended-on inside this repo

Run
called by 8
core/task-struct.go
getUserTasksLocation
called by 6
core/tasks.go
GetNative
called by 6
core/subsystem.go
ListTasksDetailed
called by 5
core/tasks.go
ensureNativeInitialized
called by 5
internal/cli/runtime.go
getNativeAndPkgManager
called by 5
internal/cli/runtime.go
SaveLastFailure
called by 4
core/task-struct.go
GetConfigValue
called by 4
settings/config.go

Shape

Function 64
Method 36
Struct 28

Languages

Go100%

Modules by API surface

internal/cli/structs.go23 symbols
internal/cli/runtime.go21 symbols
core/task-struct.go20 symbols
core/tasks.go17 symbols
core/task-checks.go12 symbols
core/updater.go10 symbols
settings/config.go8 symbols
core/utils.go8 symbols
core/subsystem.go7 symbols
cmd/main_check.go1 symbols
cmd/main.go1 symbols

For agents

$ claude mcp add vanilla-system-operator \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact