1Percent Documentation

The central hub for everything about learning with 1Percent — how the platform works, pricing and payments, installation, and the CLI & VS Code tools.

Platform Guides CLI Tool VS Code Extension

Platform documentation

Guides for learning with 1Percent — from your first visit to your first certificate.

Quick Start

Choose your tool and get started in minutes.

1% Learn CLI

Upload files, download lessons, and manage your lab from the command line. Works on macOS, Linux, and Windows.

VS Code Extension

View challenges in your editor, submit solutions with one keystroke, and track your progress — all without leaving VS Code.

Web Lab

Use the online lab at 1percent.rw/learn/lab to code directly in your browser.

1% Learn CLI

A powerful command-line tool for managing your learning files and courses.

Install the CLI

  1. Install via npm

    Install the CLI globally on your system:

    bash
    npm install -g @1percent/learn-cli
  2. Verify installation

    Check that the CLI is installed correctly:

    bash
    onepercent --version
  3. Login to your account

    Authenticate with your 1% Learn credentials:

    bash
    onepercent login
You can also set a custom API URL: onepercent login --api https://localhost:3000

Authentication

The CLI stores your authentication token locally. You only need to login once.

bash
# Login with email and password
onepercent login

# Login with inline credentials
onepercent login -e you@example.com -p mypassword

# Check current user
onepercent whoami

# Logout
onepercent logout
Your token is stored in ~/.config/1percent-learn-cli/. Never share this file.

File Management

Upload, download, and manage your lab files from the terminal.

bash
# Upload a file to your lab
onepercent upload app.js
onepercent upload main.py
onepercent upload index.html

# Upload with a custom name
onepercent upload script.js -n my-script.js

# List all your files
onepercent ls

# Pull a file from your lab
onepercent pull app.js
onepercent pull app.js -o local-copy.js

# Delete a file
onepercent rm old-file.js
onepercent rm old-file.js -y  # skip confirmation
Supported file types: .js .py .html .css .json .md .ts .sh

Course Downloads

Download course lessons for offline learning.

bash
# Download a specific lesson
onepercent download -f "programming-fundamentals" -l 1

# Download lessons 1-3
onepercent download -f "git-github" -l 1:3

# Download all lessons (requires premium)
onepercent download -f "command-line-linux" -l :

# List lessons in a course
onepercent download -f "backend-development" --list

# Download to a custom directory
onepercent download -f "databases" -l 1 -o ./my-notes
Free users can download 1 lesson per day. Upgrade for full course downloads.

VS Code Extension

Solve coding challenges directly in your code editor.

  1. Download and Install the VSIX

    Click the button above to download onepercent-learn-vscode-1.0.0.vsix, then install it directly from your terminal or VS Code:

    bash
    code --install-extension onepercent-learn-vscode-1.0.4.vsix
  2. Login

    Open Command Palette (Ctrl+Shift+P) and run 1% Learn: Login

  3. Browse challenges

    Open the Explorer sidebar and expand "1% Learn Challenges" to see available challenges grouped by difficulty.

  4. Submit your solution

    Write your code, then press Ctrl+Shift+Enter to submit. Select the challenge and view your results.

Keyboard Shortcuts

Shortcut Action
Ctrl+Shift+Enter Submit current file as solution
Ctrl+Shift+P → "1% Learn" Access all extension commands

Commands Reference

Complete list of all CLI commands.

Command Description
onepercent login Log in to your 1% Learn account
onepercent logout Log out and clear stored credentials
onepercent whoami Show current user info
onepercent upload <file> Upload a file to your lab
onepercent pull <filename> Download a file from your lab
onepercent ls List all files in your lab
onepercent rm <filename> Delete a file from your lab
onepercent premium Check your premium status and limits
onepercent premium --tiers Show all available subscription plans
onepercent download -f <course> -l <lesson> Download course lessons
onepercent download -f <course> --list List all lessons in a course
onepercent project new <name> Create a new project folder
onepercent project ls List your project folders

FAQ

What file types are supported?

Free users can upload .js, .py, .html, .css, .json, .md, .txt, and .sh files. Premium users get access to TypeScript, JSX/TSX, YAML, SQL, and more.

How many files can I store?

Free tier: 5 files (2MB). Starter: 5 files (2MB). Pro: 10 files (5MB). Unlimited: 999 files (20MB).

Can I use the CLI with a local development server?

Yes! Use onepercent login --api http://localhost:3000 to connect to a local server.

How do I reset my password?

Visit 1percent.rw/reset-password or use the "Forgot Password" link on the login page.

Is the VS Code extension free?

Yes! The extension is completely free. You just need a 1% Learn account (free tier works).