Agent Flywheel
Progress13/13
Back to Home
Agent Flywheel
Step 13 of 13
13Step 13 of 13

Congratulations! You're all set up!

Your is now a powerful coding environment ready for development.

First login: You may see a configuration wizard

When you first connect to your VPS after installation, you might see the Powerlevel10k configuration wizard — a colorful terminal setup screen.

Don't worry, this is optional! You can press q to skip it, or follow the prompts to customize your terminal appearance. ACFS already configured sensible defaults, so skipping is perfectly fine.

First: Authenticate Your AI Tools

Before using AI coding assistants, you need to authenticate them. This is a one-time setup that links your subscriptions:

1

Claude Code

Follow the prompts. If it prints a URL, open it on your laptop to log in.

Run on VPS
claude

How the authentication works:

  1. The terminal shows a URL like https://claude.ai/oauth/...
  2. Copy that URL and paste it into your web browser (on your laptop)
  3. Log in to Claude in your browser
  4. The browser shows a code (like "ABCD-1234")
  5. Copy that code and paste it back into your terminal window (the same one running Claude)

When your browser says "Paste this into Claude Code" — that means paste the code into the terminal window where you typed claude.

2

Codex CLI (if using OpenAI)

Starts the login flow. If it prints a URL, open it on your laptop to authenticate.

Run on VPS
codex login
3

Gemini CLI (optional)

Follow the prompts to authenticate (Google account).

Run on VPS
gemini

💡 Tip

After authenticating, you can use the shortcuts (vibe mode): cc (Claude), cod (Codex), gmi (Gemini).

Continue Your Learning Journey

Master your new environment with 9 guided lessons covering Linux basics, tmux sessions, AI agents, and advanced workflows.

Prefer the terminal? Run onboard for the CLI version.

Your Daily Workflow

Here's what working with your VPS looks like day-to-day:

1

Connect to your VPS

Run on your computer
ssh -i ~/.ssh/acfs_ed25519 ubuntu@YOUR_VPS_IP

Open your terminal and SSH in.

2

Resume or create a session

See existing sessions

Run on VPS
ntm list

Resume a session

Run on VPS
ntm attach myproject

Or create new

Run on VPS
ntm new myproject
3

Start coding with AI

Launch Claude Code

Run on VPS
cc
4

When you're done for the day

Detach from session:

Ctrl+AthenD

Disconnect from VPS

Run on VPS
exit

Your session keeps running! Come back tomorrow and everything is exactly where you left it.

💡 Remember: Connect → Session → Code → Detach

Starting a New Project

Ready to build something? Here's the pattern:

1. Create a session for your project

Run on VPS
ntm new my-awesome-app

This creates a persistent workspace named "my-awesome-app".

2. Create and navigate to a project folder

Run on VPS
mkdir ~/projects/my-awesome-app && cd ~/projects/my-awesome-app

3. Start Claude and describe your project

Run on VPS
cc

Tell Claude what you want to build. For example:

"Create a React app with TypeScript that shows a todo list"

💡 Tip

Claude will set up the project structure, install dependencies, and start building. You can guide it step by step or give it the whole vision at once.

Finding Your Way Around

Your home folder

Everything you create lives in /home/ubuntu (or just ~).

Go to your home folder

Run on VPS
cd ~

See what's here

List files (with icons!)

Run on VPS
lsd

We installed lsd — a prettier version of ls.

Navigate into a folder

Enter a folder

Run on VPS
cd projects

Go back up

Run on VPS
cd ..

Find files fast

Search file contents

Run on VPS
rg "search term"

Find files by name

Run on VPS
fd filename

�� Tip

Pro tip: Use z (zoxide) to jump to folders you've visited before. Just type z proj to jump to your projects folder!

Your First 5 Minutes

Let's make sure everything works with a quick test run.

1

Create a project folder

Run on VPS
mkdir ~/my-first-project && cd ~/my-first-project
2

Authenticate Claude

Run on VPS
claude

The terminal will display a URL. Copy it and open in your laptop's browser to log in, then return to your terminal.

3

Start Claude Code

Run on VPS
cc

After authenticating, this launches Claude Code.

4

Your first prompt

In the Claude prompt, type:

Create a simple Python script that prints "Hello from AI!" and run it
5

Watch the magic!

Claude will:

  • ✓ Create a file called hello.py
  • ✓ Write the Python code
  • ✓ Run the script for you
  • ✓ Show "Hello from AI!" in the output

🎉 Congratulations! You just used AI to write and run code!

Getting Back In

Closed your terminal? Here's how to reconnect:

1. Open your terminal app

Ghostty, WezTerm, or Windows Terminal

2. Connect to your VPS

Run on your computer
ssh -i ~/.ssh/acfs_ed25519 ubuntu@YOUR_VPS_IP

3. Resume your session (if using NTM)

See your sessions

Run on VPS
ntm list

Resume a session

Run on VPS
ntm attach myproject

This brings back exactly where you left off — including any running Claude sessions!

💡 Pro tip: Set up SSH config for easier access

Add this to your local ~/.ssh/config file:

Host myserver
    HostName YOUR_VPS_IP
    User ubuntu
    IdentityFile ~/.ssh/acfs_ed25519

Then just type: ssh myserver

Windows User? Set up one-click VPS access

Create a Windows Terminal profile to connect to your VPS with a single click →

What you can do now

Start Claude Code

Launch your AI coding assistant

cc

Use with

Manage terminal sessions

ntm new myproject

Search with

Fast code search

rg "pattern"

with

Visual git interface

lazygit
How to edit files manually (when AI gets something wrong)

Quick edits with nano

For simple fixes, nano is already installed on your VPS:

Open a file in nano

Run on VPS
nano hello.py

Nano shortcuts:

  • Ctrl + O, then Enter — Save
  • Ctrl + X — Exit
  • Ctrl + W — Search

Full IDE with Cursor (recommended)

Cursor is an AI-native code editor with great remote editing support (like VS Code Remote SSH).

  1. Download Cursor from cursor.com
  2. Open the command palette: Cmd/Ctrl + Shift + P
  3. Search: Remote-SSH: Connect to Host
  4. Connect to ubuntu@YOUR_VPS_IP (it will use your SSH key)

💡 Tip

Cursor is built on VS Code, so extensions work the same way — including Remote SSH. You get a full IDE experience (syntax highlighting, file explorer, extensions) while editing files directly on your VPS.

Learn more

  • Agent Flywheel GitHub Repository
  • Claude Code Documentation

Ready for the Advanced Workflow?

After completing the Learning Hub basics, dive into the powerful multi-agent workflow that lets you build production-ready software at incredible speed. You'll learn how to orchestrate multiple AI agents working in parallel, use the "best of all worlds" planning technique, and run agent swarms that build features while you sleep.

Happy coding!

Your agentic coding flywheel is ready to spin.

Launch Onboarding

Step 13 of 13|Swipe to navigate