Skip to content

Starter Guide

You don't need to code to run AI agents

From choosing a computer and setting up a terminal to explaining your first screen with a practical design toolkit.

PART 1

What makes a computer different in the agent era

An agent is like an employee who works alone for hours. It runs multiple sessions, spins up dev servers, and reads and writes files nonstop. Unlike chat-only AI use, memory capacity and OS fit strongly shape your throughput.

01

Memory equals parallel capacity

Running several agent sessions eats memory first. Apple Silicon Macs share one memory pool between CPU and GPU, which leaves more headroom for local AI work at the same capacity.

02

Sandboxed execution support

Claude Code's sandboxing works on macOS and Linux (WSL2). It's not yet supported on native Windows, so a Mac is easier if your workflow needs isolated runs.

03

Agent tools ship on Mac first

iTerm2 and cmux are Mac-only, and Ghostty supports macOS and Linux first. Most new agent-focused tools install with a single Homebrew command.

That said, Macs don't win everywhere. If you train models on NVIDIA GPUs, Linux is the better fit. This guide is written for agent operation and inference workloads.

Mac vs Windows at a glance

ItemMacWindows
Running Claude CodeNative supportNative support (PowerShell install)
Sandboxed executionSupportedWSL2 only
Agent-focused terminalsiTerm2, cmux, Ghostty, and Orca all availableMostly Orca and Windows Terminal
Tool installationUnified via HomebrewInstall paths vary per tool

Before you buy, answer 4 questions to size your specs. The picks below follow the same criteria.

3-minute match

What will you use this Mac for the most?

Good builds to buy now

A lineup picked for agent work. 16GB of memory is the starting line; go 24GB or more if you run many sessions in parallel.

MacBook Pro M5 in Space Black

MacBook Pro M5

Recommended

24GB+ memory recommended

Multiple agent sessions plus local servers: the safest choice as a main machine.

View on Coupang
MacBook Air M5 in Sky Blue

MacBook Air M5

16GB+ memory

Plenty for getting started when you want to begin light.

View on Coupang
Mac mini M4 in Silver

Mac mini M4

Desk setup

A desk build that buys you more memory for the same budget.

View on Coupang
Mac Studio in Silver with the M4 Max chip

Mac Studio M4 Max

36GB unified memory · 512GB SSD

Built for long parallel workloads and local models when you want one serious desk machine.

View on Coupang
Microsoft Surface Laptop family

Windows laptop

32GB+ RAM with WSL2

If you must stay on Windows, get generous memory and pair it with WSL2.

View on Coupang

This page contains Coupang Partners affiliate links; qualifying purchases may benefit QJC.

Want a deeper pick for AI work? See the Mac guide

Real footage

Curious what an agent actually doing company work looks like? Start with this video.

PART 2

The terminal: your agent's office

What is a terminal?

A window where you talk to your computer in text. Instead of clicking icons, you type commands and the computer runs them as written. It looks foreign, but you only use a handful of rules daily.

Why does it matter now?

Because agents like Claude Code live and work inside the terminal. Once you're comfortable there, you gain a control room for running several agents at once.

iTerm2

macOS

The Mac terminal standard

A long-refined Mac-only terminal. Strong split panes and shortcuts make it great for keeping agent sessions side by side.

brew install --cask iterm2Official site

Ghostty

macOS · Linux

Fast, with minimal setup

Renders with the GPU, so it stays smooth even with heavy agent output. Sensible defaults let you use it right after install.

brew install --cask ghosttyOfficial site

cmux

macOS

Built for agent notifications

A terminal made for AI coding agents. When an agent waits for input, an indicator lights up, so you miss less while running many sessions.

brew tap manaflow-ai/cmux && brew install --cask cmuxOfficial site

Orca

macOS · Windows · Linux

Fleet control for agents

An orchestrator that runs multiple agents side by side, each isolated in its own working folder. A companion app lets you check progress from your phone.

brew install --cask stablyai/orca/orcaOfficial site

If you're on Windows

Claude Code installs natively on Windows too. Some features like sandboxing need WSL2, so check the setup criteria in Part 3.

Locked content preview

  • iTerm2

  • Ghostty

  • cmux

  • Orca

  • Shared rules for running agents in parallel
Part 3 · Students only

This part is open to our students

The small, annoying problems every terminal throws at you, we've already worked through them for you.

  • Setup recipes for all 4 terminals, click by click
  • Rules for running multiple agents in parallel
  • Content that keeps updating as the tools change
Explore Singularity Builders

Already a student? Log in to continue

PART 4 · FREE

A design toolkit to explain the screen you want

A reference is an example that shows what you want to build. Give your AI one screen you like and explain why you like it to set a clearer direction than “make it look nice.”

Start with this simple route

Pick a first screen from Supahero, then a palette from Color Hunt. Add shadcn/ui when you need buttons or inputs. You do not need all 20 sites to get started.

A hero is the first section of a page. Components are interface parts such as buttons and inputs. A palette is a set of colors used together, and a landing page introduces a product or service.

  1. 1. Pick one example

    Expand a category below. Save an example URL or screenshot and note two things you like, such as a large heading or generous spacing.

  2. 2. Give your AI your own content

    Send the example and prompt below to Claude Code or your AI tool. Attach a screenshot if it cannot read the link. For sites offering code, ask it to check compatibility with your project first.

  3. 3. Check a small screen first

    Build just the first screen, then check readability and buttons on your phone. Request one change at a time, such as making the mobile heading fit on two lines.

20 resources to open when you need them

Site names open in a new tab. Check each service for account requirements, pricing, and template usage terms.

When you need a layout

Choose an overall mood and layout from a gallery.

  • Supahero

    Browse hero sections and pick a heading, image, and button layout you like.

  • Dark Design

    Explore dark websites and look for readable text and visible buttons.

  • Macapp Supply

    Explore well-designed macOS apps and study their product descriptions and images.

  • GetLayers

    Preview web templates and effects, then adapt the provided AI prompt to your own content.

  • loadmo.re

    Explore distinctive mobile websites, their navigation, and vertical scrolling layouts.

When you need buttons, inputs, or motion

Components are building blocks for developers. Pick an example and ask your AI to adapt it to your project.

  • Beautiful UI

    Choose interface parts for AI chat, waiting and progress states, and task approvals.

  • beUI

    Preview animated React and Next.js components and start with one useful placement.

  • Rare UI

    Pick a distinctive animated React component and check that it stays comfortable on mobile.

  • Transitions

    Share an example of a menu or card transition with your AI.

  • shadcn/ui

    Explore basic interface parts such as buttons, inputs, and dialogs for your first app.

When you need a color palette

Choose colors, then check that text stands out from its background.

  • Realtime Colors

    Preview colors and fonts in a website layout and compare readability.

  • Coolors

    Generate or browse color combinations and give your AI the codes and a role for each color.

  • Paletton

    Use a color wheel to compare combinations that work with your brand color.

  • Khroma

    Start by choosing colors you like so this AI tool can suggest combinations that suit your preferences.

  • Color Hunt

    Browse ready-made palettes and assign background, text, and accent colors.

When you need a brand direction or improvements

Explore brand examples, written design rules, and product improvement tools.

  • Stanley

    Study this AI content service as a branding example: its character, wording, and colors.

  • oh-my-design

    Read the GitHub README, then share a relevant company design reference document with your AI.

  • Lazyweb

    Check the current features of this product growth service before using its ideas to improve your page.

When you need more components or charts

Add only what you need after the basic screen works.

  • 21st.dev

    Search React components and templates, then share a preview URL with your AI.

  • Tremor

    Choose a React chart or dashboard component that fits your data, such as sales or learning progress.

Try this request with your AI

Click the box to select the whole prompt, then press Ctrl+C (⌘C on Mac). Replace the bracketed parts with your details. On a phone, long-press to copy.

Check these three things before you finish

Check for horizontal overflow on your phone, readable text against the background, and buttons that open the intended destination. Use your own content and permitted assets instead of copying another site’s logo, photos, or wording.

You've made it this far. Next comes the real thing.

Singularity Builders is an AI agent bootcamp we run both in person and online. We'll go from setup to real work together.

Learn about Singularity Builders
AI Agent Starter Guide: From Computer to Terminal Setup | QJC