Fast.io CLI

Your Workspaces,
From the Terminal.

Manage workspaces, files, and AI from your terminal. Open source.

fastio — zsh

Three Steps to Start

From zero to workspace in under a minute.

Install

npm install --global @vividengine/fastio-cli

Authenticate

fastio auth login
# Opens your browser for secure OAuth

Start Using

fastio ai chat --workspace acme-q4 "What files do I have?"

Authentication

The CLI checks credentials in this order: --token flag, FASTIO_TOKEN env var, FASTIO_API_KEY env var, then stored credentials from your profile.

PKCE Browser Login recommended

fastio auth login
# Opens your browser for secure OAuth
# Tokens are stored locally and auto-refreshed

Email/Password

fastio auth login --email user@example.com --password ****

API Key for CI/CD

# Create an API key
fastio auth api-key create --name "CI pipeline"

# Use it for subsequent commands
export FASTIO_API_KEY=your-key-here
fastio org list

Two-Factor Authentication

# Check 2FA status
fastio auth 2fa status

# Enable 2FA
fastio auth 2fa setup --channel totp

# Verify after login
fastio auth 2fa verify <code>

Commands

20+ command groups. Run fastio --help or append --help to any command for details.

Authentication & User

authLogin, logout, 2FA, API keys

userProfile, search, invitations

configureProfiles and settings

Organizations & Workspaces

orgOrg CRUD, billing, members

workspaceWorkspace CRUD, templates

memberMember management

invitationAccept, decline, delete

Files & Storage

filesList, move, copy, delete, search

uploadChunked upload, URL import

downloadStream, ZIP, batch download

lockAcquire, check, release locks

Shares & Collaboration

shareCreate, manage, password-protect

commentComments, replies, reactions

eventActivity events, polling

previewFile preview URLs

AI & Workflow

aiChat, search, summarize

taskTasks, lists, assignment

worklogActivity log entries

approvalRequest, approve, reject

todoTodo items, bulk ops

Platform

importCloud import (Drive, Box, etc.)

appsApp listing and launching

mcpStart built-in MCP server

completionsShell completions

Output Formats

All commands support --format to control output. JSON is the default when piped.

# Table format (default for terminals)
fastio org list

Shell Completions

Tab completion for commands, flags, and arguments.

fastio completions bash > ~/.bash_completion.d/fastio

Profiles

Manage multiple accounts with named profiles.

# Set up a profile interactively
fastio configure init

# Log in to a specific profile
fastio auth login --profile work

Configuration

Config files are stored in ~/.fastio/.

File	Purpose
`config.json`	Profile settings and API base URL
`credentials.json`	Stored authentication tokens

Global Options

Flag	Description
`--format json\|table\|csv`	Output format
`--fields name,id,...`	Filter output fields
`--no-color`	Disable colored output
`--quiet / -q`	Suppress all output
`--verbose / -v`	Debug logging
`--profile <name>`	Use named profile
`--token <jwt>`	One-off bearer token
`--api-base <url>`	Override API base URL

50 GB free. No credit card. See pricing

Frequently Asked Questions

How is this different from the REST API?

The CLI wraps the REST API in a developer-friendly binary with auth management, progress bars, output formatting, and shell completions. Use the CLI for interactive work and scripts; use the API when you need fine-grained control.

Does it work with CI/CD?

Yes. Use the FASTIO_API_KEY environment variable for non-interactive authentication. JSON output (--format json) pipes cleanly into downstream tools. The CLI is designed for automation.

Can AI agents use the CLI?

Yes. Agents that spawn shell processes can invoke fastio commands directly. The CLI outputs structured JSON (--format json) that agents can parse easily.

What authentication methods are supported?

PKCE browser login (recommended), email/password, API keys, environment variables (FASTIO_TOKEN or FASTIO_API_KEY), bearer tokens via --token flag, and named profiles for managing multiple accounts.

Is it open source?

Yes. Apache 2.0 license. The source code is available at github.com/MediaFire/fastio_cli. Built in Rust for speed and reliability.

What platforms are supported?

macOS (Apple Silicon and Intel), Linux (x86_64 and ARM64), and Windows. Install via npm, a curl shell script, or download pre-built binaries from the GitHub releases page.

Start Building from the Terminal

Install the CLI, connect your workspace, and ship. 50 GB free.

Your Workspaces, From the Terminal.