Getting started - Teneo CLI x Cursor
Install Teneo CLI withCursor
Use Cursor's built-in terminal or Agent mode to install the Teneo CLI in under ten minutes.
Works on Windows, Mac, and Linux.
Time to complete
~10 min
Goal
Teneo CLI installed, ready to run
Requirements
Cursor + Node.js
Difficulty Level
Beginner
This tutorial uses Cursor to install the Teneo CLI. Cursor is an AI-first code editor built on VS Code. You can run the install command in Cursor's integrated terminal, or ask Cursor's Agent to run it for you. Either path takes the same amount of time.
Cursor runs on Windows, macOS, and Linux. If you already have it installed, skip straight to Step 2.
In this tutorial
What you get
- Access to 50+ Teneo agents directly from inside your editor
- A CLI you can call from Cursor's integrated terminal or any other shell
- A selection of free agents you can query right away, no wallet funding needed
Cursor installed (free tier works), Node.js 18 or later. No prior experience with blockchain or AI agents required.
Resources
Docs, repos, and related tutorials
Everything referenced in this tutorial, plus a few adjacent paths if Cursor isn't your preferred editor.
Resources
Docs, repos, and related tutorials
Requirements
- Cursor (free tier or Pro)
- Node.js 18 or later (
node --versionto check) - A local folder to install the CLI into
- Later, a wallet + USDC for paid agent queries
Troubleshooting
- If
npxis not found, Node.js is not installed or not on your PATH - On Windows, the default terminal shell is PowerShell. Bash and Git Bash also work if you prefer
- If the install stalls, check your internet connection and re-run the command
- Never paste your seed phrase into Cursor's Agent chat or any other interface
Step 1: Cursor
Install Cursor
Download and install the Cursor editor. Skip this step if you already have it.
Step 1: Cursor
Install Cursor
Action 1: Download Cursor
Go to cursor.com and download the installer for your operating system. Cursor is available for Windows, macOS, and Linux.
The Cursor download page. Select your operating system.
Action 2: Run the installer
Open the downloaded installer and follow the prompts. Cursor installs like any other desktop application. On first launch it will ask you to sign in or create a free account.
Action 3: Verify Node.js is installed
The Teneo CLI installs via npx, which ships with Node.js. Open any terminal and run:
node --versionYou need version 18 or later (for example v20.11.0). If Node.js is not installed, download it from nodejs.org before continuing.
Step 2: Project folder
Open a project folder
Create a local folder and open it in Cursor. This is where the CLI files will land.
Step 2: Project folder
Open a project folder
Cursor needs an open folder so the integrated terminal has a working directory. Before you run the install command, point Cursor at a dedicated folder for the Teneo CLI.
Action 1: Create a folder on your machine
Create a new folder anywhere you can find it again: Desktop, Documents, or a dedicated dev directory. A name like teneo-cli or Teneo CLI is enough.
Creating a local folder in Windows Explorer
Creating a local folder in macOS Finder
Action 2: Open the folder in Cursor
In Cursor, go to File > Open Folder (or press CtrlK CtrlO on Windows/Linux, or CmdK CmdO on macOS). Select the folder you just created. Cursor will reload with that folder as the workspace root.
File > Open Folder opens a system folder picker. Select your Teneo CLI folder.
Step 3: Install CLI
Install the Teneo CLI
Ask the Cursor Agent to run the install, or open the terminal and run it yourself.
Step 3: Install CLI
Install the Teneo CLI
Action 1: Start a conversation in your workspace
With your folder open, start a new Agent conversation in Cursor. Open the Agent panel with CtrlI (Windows/Linux) or CmdI (macOS), or press CtrlShiftL for a new Agent. Make sure Agent mode is selected in the dropdown at the bottom of the panel.
The Agent panel open on the right, ready to send the install prompt inside your open workspace.
Action 2: Send the install prompt
Paste the following prompt into the conversation and send it. Cursor will request terminal permission, run the install command in your open folder, and report back when done.
install this: npx @teneo-protocol/cliAction 3: Wait for the install to complete
The agent downloads the CLI bundle, sets up a background daemon, and generates a wallet. This typically takes under a minute. The agent confirms in the conversation when the install is finished, listing the installed version and CLI location.
The agent runs npx @teneo-protocol/cli and reports back once the CLI is installed.
Done. You can now query agents.
The Teneo CLI is installed in your folder. You now have access to the decentralised network of AI agents that make up Teneo Protocol.
Each agent is a live AI endpoint. You send a query in natural language, the CLI routes it to the relevant data sources, and you get structured output back.
Agent pricing is set per query by the agent builder and paid in USDC on PEAQ, Base, or Avalanche via x402 micropayments. Try a free agent first before funding your wallet.
In Cursor, press Ctrl` (backtick) on Windows/Linux or Cmd` on macOS to open the integrated terminal at the root of your open folder. You can also go to Terminal > New Terminal from the menu bar, then run
npx @teneo-protocol/cli directly. The result is identical to letting the agent run it.Reference
What got installed
When you run npx @teneo-protocol/cli, these files land in teneo-skill/ inside your folder.
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 |
The
teneo script is a Unix shell script. On Windows, run it via node teneo.mjs directly, or use WSL if you prefer a bash environment. On macOS and Linux, ./teneo works as-is once you mark it executable with chmod +x teneo.Ask the agent what got installed and it lists the CLI bundle, agent skill, and auto-generated wallet.
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 with Cursor's Agent, in any terminal session, or in any text file inside your project folder. This wallet holds real funds. 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.