Agentlas
Agentlas
Search docs…⌘K
← Back to app
IntroductionFeaturesIntegrationsLegalTips & TricksChangelog
Start here

Absolute beginner setup

This is the slow, no-shame setup guide. It assumes you have never installed a coding tool, pasted a Terminal command, or used an AI agent package before.

Setup flowchart
Click any node to jump to that step. The vertical spine is required; the side branch is optional.
Agentlas setup
↓
Required steps run top to bottom. Optional branches are alternatives, not extra homework.

Make your first Agentlas agent

Start with one small recurring job. Agentlas should generate the draft first; install apps only when you are ready to hand that package to Codex, Claude, or Desktop.

AI app composer with the prompt field highlighted and install this agent typed
In Codex, Claude, or any terminal agent, drop or paste the Agentlas package path, type install this agent, then press Return.
  1. Go to Agentlas and sign in before creation.
  2. Create a single agent or an agent team from one real recurring job.
  3. Review the generated draft, especially purpose, inputs, tools, schedule, and security warnings.
  4. Download or import the reviewed Agentlas package.
  5. In Codex, Claude, or a terminal agent, drag/drop the ZIP or paste the file path.
  6. Type install this agent and press Return.
Return to Agentlas and create the first draft →
Start from the top creation cards or a real workflow example.

What you are installing

You do not need every tool on this page to try Agentlas. The web app can create and review an agent package first. Codex app, Claude Code, Terminal, and Agentlas Desktop are the tools that help you run the package on your own computer later.

Agentlas Web
Where you describe the work, answer a few questions, review the agent/team, and save the draft.
Agentlas Desktop
Where recurring work runs locally with the AI accounts, files, tools, and credentials you already control.
Codex app
A visual OpenAI desktop app for asking Codex to work inside a local project folder.
Claude Code
Anthropic's coding-agent tool. It is useful if you want Claude to install or use an exported agent package.
Terminal
A text window where you paste one command, press Return, and let an installer do the work.
INFO · The shortest safe path
  1. Create a free Agentlas account.
  2. Click one workflow example or Single agent.
  3. Describe one real recurring job.
  4. Review the draft and security notes.
  5. Open Agentlas Desktop when you are ready to run it repeatedly.

Install the Codex app

Use this if you want a visual desktop app instead of starting in Terminal. Open the official Codex app page, choose the download for your computer, open the downloaded installer, then sign in.

Official Codex download page with the Download for macOS button highlighted
Click the highlighted Download for macOS button on the real Codex page. Use the Windows link underneath if you are on Windows.
  1. Open the official Codex app page.
  2. If you use a newer Apple silicon Mac, click Download for macOS (Apple Silicon). If you use an Intel Mac, choose the Intel build. On Windows, choose the Windows download.
  3. Open the downloaded file. If macOS asks whether to open it, confirm that it came from OpenAI.
  4. Open Codex and sign in with your ChatGPT account or OpenAI API key.
  5. When Codex asks for a project, choose the folder where you keep the work you want AI help with.
  6. Before sending your first message, make sure Local is selected so Codex works on your machine.
Open the official Codex app page →
Use the official download buttons because app installers can change.

Terminal basics before you paste anything

Terminal is not a chat box. It runs commands on your computer. The beginner rule is simple: copy the exact command from the trusted source, paste it once, press Return or Enter once, and wait.

Mac: open Terminal from Spotlight

Mac Spotlight search with Terminal typed
On Mac, press Command + Space, type Terminal, then press Return.
  1. Press Command + Space.
  2. Type Terminal.
  3. Press Return.
  4. Click inside the Terminal window before you paste.
  5. Paste with Command + V, then press Return once.

Windows: open Terminal from Start search

Windows Start search with Terminal typed
On Windows, click Search beside Start, type Terminal, then open Windows Terminal or PowerShell.
  1. Click Search beside the Start button.
  2. Type Terminal.
  3. Open Windows Terminal. If you only see PowerShell, open PowerShell.
  4. Use a PowerShell tab unless a guide specifically says CMD or WSL.
  5. Paste with Ctrl + V, then press Enter once.
  1. Copy the whole command from the guide. Start at the first character and end at the last character.
  2. If the installer prints text for a while, wait. If you think something is wrong, stop with Control + C and read the error message.
HEADS UP · Never paste random install commands

Only paste install commands from the official product docs, this Agentlas guide, or a source you already trust. If a command includes sudo and you do not understand why, pause first.

Install Node.js and npm

npm usually comes with Node.js. For beginners, do not hunt for a separate npm installer first. Install the official Node.js LTS package, then verify both commands in Terminal or PowerShell.

Node.js download page explaining that the installer includes npm
Download Node.js LTS from nodejs.org. The installer includes npm.
node -v
npm -v
  1. Open the official Node.js download page.
  2. Choose the LTS installer for your operating system.
  3. Run the installer with the default options.
  4. Close Terminal or PowerShell completely.
  5. Open Terminal or PowerShell again.
  6. Run node -v and npm -v. If both print version numbers, npm is ready.
Open the official Node.js download page →
Use this when npm is missing, because npm ships with Node.js.

Run Codex and Claude from Terminal

You do not need both Codex CLI and Claude Code. Install the one you actually pay for or already use. If you want to test both, run one installer, wait until it finishes, then type codex or claude and press Return or Enter.

Mac: Codex and Claude commands

Mac Terminal showing node, npm, codex, and claude commands
On Mac, paste one install command, wait, then type codex or claude and press Return.
# Check Node/npm first if you plan to use npm-based tools
node -v
npm -v

# Codex CLI for macOS or Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex

# Claude Code for macOS, Linux, or WSL
curl -fsSL https://claude.ai/install.sh | bash
claude

Windows: Codex and Claude commands

Windows Terminal PowerShell showing node, npm, codex, and claude commands
On Windows, use PowerShell. Paste one command at a time, press Enter, then wait.
# Check Node/npm first
node -v
npm -v

# Codex CLI with npm
npm install -g @openai/codex
codex

# Claude Code with the native PowerShell installer
irm https://claude.ai/install.ps1 | iex
claude
INFO · Windows note

Codex also supports WSL2 for Linux-style workflows, and OpenAI's Windows guidance can change as the native sandbox improves. If a Windows command fails, open the official Codex Windows page linked below instead of improvising.

Open the official Codex Windows guide →
Use this when Windows Terminal, sandbox, or WSL setup is confusing.
Open the official Codex CLI page →
Use this for current install commands, upgrades, and account requirements.
Open the official Claude Code install page →
Use this when your OS is unusual, a command fails, or your company manages installs.

Install Claude Desktop

Start with the normal Claude desktop app if you want a visual place to talk to Claude. Use the Terminal section above only when you want Claude Code to work with exported Agentlas files from Terminal.

Official Claude download page with the Download for macOS button highlighted
Click the highlighted Download for macOS button on the real Claude page. The smaller Desktop card below also has macOS and Windows download buttons.
HEADS UP · About npm and sudo

Anthropic also supports npm, but their docs warn against sudo npm install -g because it can create permission and security problems. Use the native installer first unless you already know your Node setup.

  1. Open the official Claude download page.
  2. Click the download button for your operating system.
  3. Open the downloaded installer.
  4. Launch Claude Desktop and sign in.
  5. If you later want Terminal Claude, return to the OS-specific Claude Code commands above.

Give the Agentlas ZIP to Codex or Claude

After Agentlas exports a ZIP, the easiest terminal-agent handoff is to give Codex or Claude the exact file path and a plain instruction. Do not unzip random files blindly. Ask the agent to read README.md first.

Mac: drag the ZIP into Terminal

Mac Terminal showing an Agentlas ZIP dragged into the prompt
On Mac, drag the downloaded Agentlas ZIP into Terminal so the file path appears.
  1. Open Terminal.
  2. Type codex or claude, then press Return.
  3. Type: Install this Agentlas ZIP:
  4. Open Downloads in Finder.
  5. Drag the Agentlas .zip file into Terminal. A file path should appear.
  6. Press Return.
  7. Then send: Read README.md first, install this agent, and tell me how to call it.

Windows: copy the ZIP path into Terminal

Windows Terminal showing an Agentlas ZIP path pasted into PowerShell
On Windows, copy the ZIP path from Explorer, paste it into PowerShell with Ctrl + V, then ask the agent to install it.
  1. Open Windows Terminal or PowerShell.
  2. Type codex or claude, then press Enter.
  3. Open Downloads in File Explorer.
  4. Select the Agentlas .zip file and press Ctrl + C.
  5. Click inside Terminal and press Ctrl + V. If no readable path appears, right-click the file and choose Copy as path, then paste again.
  6. Press Enter.
  7. Then send: Read README.md first, install this agent, and tell me how to call it.

Install Agentlas Desktop

Agentlas Desktop is the local runtime. Use it when the web draft looks right and you want the work to become a repeatable operator on your computer.

  1. Open the Agentlas Desktop page.
  2. Choose the download for your operating system.
  3. On macOS, open the DMG, drag Agentlas into Applications if the installer asks, then open Agentlas from Applications.
  4. On Windows or Linux preview builds, use the release-page instructions shown by the Desktop page.
  5. Open Agentlas Desktop and connect the AI accounts or local credentials the agent actually needs.
  6. Import the reviewed Agentlas package from your web draft, downloaded ZIP, local folder, or Cloud catalog.
Open Agentlas Desktop downloads →
The page shows release status before sending you to a download.

Agentlas Desktop: Agents, then Cloud

Agentlas Desktop Library Agents screen with the Cloud button highlighted
In Agentlas Desktop, open Library, choose Agents, then click Cloud to browse or import Agentlas packages.
  1. Open Agentlas Desktop.
  2. In the sidebar, click Library.
  3. Open the Agents tab.
  4. Click Cloud when you want Agentlas cloud/catalog packages.
  5. Click Local folder when you already unzipped a package on this computer.
  6. Select the agent, start a new chat, and type the recurring business task you want it to run.
NOTE · What Cloud means here

Cloud is a browse/import handoff for Agentlas packages and account-linked catalog work. Desktop is still the place where recurring local work uses the accounts, files, tools, and credentials you connect.

Copy-paste checklist

# Mac: open Terminal from Spotlight
# Windows: open Windows Terminal from Start search

# Check Node/npm after installing Node.js LTS
node -v
npm -v

# Mac Codex CLI
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex

# Windows Codex CLI
npm install -g @openai/codex
codex

# Mac/Linux/WSL Claude Code
curl -fsSL https://claude.ai/install.sh | bash
claude

# Windows PowerShell Claude Code
irm https://claude.ai/install.ps1 | iex
claude

# Agentlas ZIP handoff prompt
Read README.md first, install this agent, and tell me how to call it.

When something breaks

command not found
Close Terminal, open a new one, and try again. If it still fails, the installer may not have added the command to PATH.
permission denied
Do not add sudo randomly. Read the official troubleshooting page or ask someone technical to inspect the exact error.
password typing is invisible
That is normal in many Terminal password prompts. Type the password and press Return.
download blocked on macOS
Open System Settings and confirm the app only if it came from the official Agentlas, OpenAI, or Anthropic page.
I do not know which folder to choose
Pick the folder where your business files or project files live. If you are only testing, create a new folder named Agentlas Test.
Absolute beginner setup · Agentlas docs