Analyze local C++ before you submit.

Run algovis from terminal against local competitive-programming files. The CLI uses the same native analyzer as the site, without calling Vercel or Render.

$ algovis analyze solution.cpp

Downloads

Direct binaries

Start with the macOS Apple Silicon build. Linux is planned next.

macOS Apple Silicon Download Native arm64 terminal binary. Unsigned first build. Beginner? click here

Linux / WSL Coming soon Native terminal binary

Commands

Two output modes.

notation is the default and prints a short labeled time and space summary. full prints the readable report. Use algovis --help any time to see the commands again.

notation

algovis analyze file.cpp
algovis analyze notation file.cpp
algovis analyze file.cpp --notation

stdout contains a compact summary, such as Time: O(n * log n) and Space: O(n).

full

algovis analyze full file.cpp
algovis analyze file.cpp --full

Includes time, auxiliary space, rough constraints, signals, and notes.

Install

Install the Apple Silicon binary.

The default install goes into your own user folder, so it does not need sudo or an admin password.

tar -xzf algovis-macos-apple-silicon.tar.gz
cd algovis-macos-apple-silicon
mkdir -p ~/.local/bin
cp algovis ~/.local/bin/algovis
chmod +x ~/.local/bin/algovis
algovis --help
algovis analyze ~/Downloads/solution.cpp

Update

Replace the old CLI with the newest one.

Download the latest Apple Silicon archive again, unpack it, then overwrite the copy in ~/.local/bin. No password needed.

cd ~/Downloads
tar -xzf algovis-macos-apple-silicon.tar.gz
cd algovis-macos-apple-silicon
cp algovis ~/.local/bin/algovis
chmod +x ~/.local/bin/algovis
hash -r
algovis --help

Downloads

Your OS is not packaged yet.

The analyzer is still available in the web app. Native Linux / WSL builds are planned, but the current direct download is macOS Apple Silicon only.

# Available now on macOS Apple Silicon
algovis analyze solution.cpp

# Linux / WSL binary
coming soon

Beginner setup

Install and use it from zero.

Use this if you are comfortable downloading the CLI but not sure what to do after the file lands in your Downloads folder.

Download the macOS Apple Silicon file.
Click the macOS Apple Silicon download card above. Your browser should save a file named algovis-macos-apple-silicon.tar.gz, usually into Downloads.
Open Terminal.
Press Command + Space, type Terminal, then press Enter.
Go to your Downloads folder.
```
cd ~/Downloads
```

Unpack the downloaded file.

tar -xzf algovis-macos-apple-silicon.tar.gz

Move into the unpacked folder.
```
cd algovis-macos-apple-silicon
```
Install the command.
This copies algovis into your own home folder. It should not ask for your macOS password.
```
mkdir -p ~/.local/bin
cp algovis ~/.local/bin/algovis
chmod +x ~/.local/bin/algovis
```
Check that Terminal can find it.
```
algovis --help
```
If this prints the Algovis command list, the install worked.
Only if you see “command not found,” add it to PATH.
Most setups already include ~/.local/bin. If yours does not, run this once and then try algovis --help again.
```
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
algovis --help
```
If macOS blocks the app, allow it.
This first build is unsigned. Go to System Settings > Privacy & Security, scroll to the security message, and allow algovis. Then run the command again.
Analyze your C++ file.
```
algovis analyze notation ~/Downloads/solution.cpp
```
Replace solution.cpp with your file name. You can also drag the file from Finder into Terminal after typing algovis analyze notation ; macOS will paste the full path for you.
If the file is in Downloads, the short name also works.
```
algovis analyze notation solution.cpp
```
If a bare filename is not in your current Terminal folder, Algovis also checks ~/Downloads, ~/Desktop, and ~/Documents.
Use the full report when you want details.
```
algovis analyze full solution.cpp
```
notation prints the short Time and Space summary. full prints time, auxiliary space, constraints, signals, and notes.

Update later by overwriting the old command.

When a newer CLI is released, download the archive again and replace your existing copy.

cd ~/Downloads
tar -xzf algovis-macos-apple-silicon.tar.gz
cd algovis-macos-apple-silicon
cp algovis ~/.local/bin/algovis
chmod +x ~/.local/bin/algovis
hash -r
algovis --help

Accepted files

The CLI is intentionally C++ only.

.cpp .cc .cxx .hpp .hh .hxx

Advanced install

Optional system-wide install, if you specifically want it in /usr/local/bin. This may ask for your password.

sudo install -m 755 algovis /usr/local/bin/algovis