Getting started - Teneo CLI x Codex
Install Teneo CLI toCodex
Install the Teneo CLI in a few minutes using OpenAI's Codex desktop app.
No prior coding experience is required.
Time to complete
~10 min
Goal
Teneo CLI installed, ready to run
Requirements
OpenAI account
Difficulty Level
Beginner
In this tutorial
What you get
- Direct access to 50+ Teneo agents from inside Codex
- Scrape, swap, bridge, and query on-chain data in plain English
- A selection of free agents you can query right away, no wallet funding needed
An OpenAI account with access to Codex. No prior coding experience required. Codex handles the actual installation for you.
Resources
Docs, repos, and related tutorials
Everything referenced in this tutorial, plus a few adjacent paths if Codex isn't your preferred route.
Resources
Docs, repos, and related tutorials
Official docs
Related tutorials
Requirements
- OpenAI account with Codex access
- A local folder on your machine to install into
- (Later) a wallet + USDC for paid agent queries
Troubleshooting
- If the install stalls, check your internet connection and re-run the prompt
- If
npxcan't find the package, re-run with an internet connection - Never paste your seed phrase or private key into Codex or any chat
Step 1: Codex
Open Codex
We're using the Codex desktop app for this tutorial.
Step 1: Codex
Open Codex
In this tutorial we're using the Codex desktop app. It's the easiest way to follow along.
Codex also runs in the browser, in the terminal, and inside your IDE. If you already have one of those set up, the rest of this tutorial still applies with minor adjustments.
Downloading the Codex desktop app is easy. Grab it from the link below, install it, then open Codex.
Step 2: Local folder
Create a local folder
A dedicated folder on your machine that Codex will use as its working directory.
Step 2: Local folder
Create a local folder
Before you install the Teneo CLI, you need a folder on your machine for it to live in. Codex will use this folder as its working directory when you run the install prompt.
Action 1: Create a local folder
Create a new folder on your computer. You can put it anywhere you like: Desktop, Documents, or any other location you can easily find again.
Creating a local folder in Windows Explorer
Creating a local folder in macOS Finder
Action 2: Name the folder
Name the folder whatever you like. We recommend Teneo CLI so it's obvious what's inside when you come back to it later.
Step 3: Install CLI
Install the Teneo CLI
Open Codex, point it at your folder, and send one prompt.
Step 3: Install CLI
Install the Teneo CLI
Action 1: Open the Codex desktop app
Launch the Codex desktop app. Once it opens, you are ready to point it at the local folder you created in Step 2.
Action 2: Add a new project and select the folder you created
From the Codex home screen, click Add a new project. Choose the local folder you created in Step 2 (for example Teneo CLI). This tells Codex where to install the Teneo CLI files.
Adding a new project in Codex and selecting the local folder
Action 3: Send the install prompt
With Codex pointed at your folder, paste the following prompt and send it:
install this: npx @teneo-protocol/cliCodex will run the install command, set up the CLI binaries, and confirm when it's done.
If you're using Codex in the terminal, you can also run the install command directly in your shell:
npx @teneo-protocol/cliAction 4: Wait for the install to complete
Codex will download the package, install the binaries, and display a confirmation. This typically takes under a minute depending on your connection.
Codex after successful Teneo CLI installation
Done. You can now query agents.
The Teneo CLI is installed. You now have access to the growing decentralised network of AI agents that make up Teneo Protocol.
Each agent is an AI endpoint. You send a query in natural language, the CLI routes it to live data sources, and your coding agent returns structured output.
Pricing is set per query by the agent builder and paid in USDC on our supported blockchain networks via x402.
Each agent can do things like scrape social media, pull crypto analytics, access prediction markets, and even execute token swaps. Try a free agent first to see the CLI in action.
Your CLI auto-generates its own wallet on install. You can fund that wallet later to query paid agents on Teneo Protocol. We'll cover funding your wallet and walking through specific agents in follow-up tutorials.
Reference
What got installed
When you run npx @teneo-protocol/cli, these files land in ~/teneo-skill/.
Reference
What got installed
| File | Purpose |
|---|---|
| teneo | Bash wrapper script (4 lines). Sets a 24h daemon idle timeout and runs teneo.mjs via Node |
| teneo.mjs | The actual CLI (~1.4 MB JavaScript bundle) |
| daemon.mjs | Background WebSocket daemon (~3.9 MB) that maintains a persistent connection to the Teneo backend |
| greetings.install.md | The greeting text shown during install |
Important
Before you start querying
Wallet setup, funding, and safety.
Important
Before you start querying
What to know
- Installing the CLI auto-generates a wallet for you
- You can fund the wallet to interact with pay-per-query agents via x402 micropayments (USDC on PEAQ, Base, or Avalanche)
- Some agents are free to query. No funding needed to start exploring
- Fund your wallet in small increments to cover query fees. There is no minimum.
Never share your seed phrase. This wallet holds real funds. Fund it in small increments. Only what you need to cover query fees. Treat it like cash. Teneo cannot recover lost or compromised wallets.
A follow-up tutorial will cover querying specific agents live on Teneo Protocol, checking agent directories, and understanding query pricing. In the meantime, try running a query against one of the free agents to see the CLI in action.