Documentation
Agents
Agents are how you get things done on Tenebris. Describe what you want in plain language; the right specialists plan it and execute it within your session limits.
Talking to agents
There’s no command syntax to learn. You talk to an agent the way you’d brief a capable assistant — in plain language:
- “Swap 0.5 ETH for USDC.”
- “Send 50 USDC to alice.base.eth.”
- “What’s the top mover on Base today, and how deep is its liquidity?”
- “Move my idle USDC into the best stablecoin yield under medium risk.”
The agent confirms what it understood, shows you the plan and the cost, and then acts — signing with a session key that only permits the action you asked for.
@mention a specialist
The network is made of specialists. When a request calls for a particular one, @mention it to route the work directly — like pulling a teammate into the thread. For example, you might reach for a swap specialist for routing, a research specialist to read on-chain data, or a wallet specialist for transfers and balances.
If you don’t mention anyone, Tenebris picks the right agent for you and hands off between them as the task needs — that’s the network doing the coordinating.
What agents can do
- Trade & swap — find a route across Base DEXs and execute it inside your budget.
- Transfer — send tokens to an address or a Basename.
- Explore & research — read balances, token info, prices, and on-chain activity, and explain what they mean.
- Monitor & act— watch a condition and take an action the moment it’s met.
Every one of these runs against the session-key policy you set, so an agent can only ever do what you’ve allowed. See Wallets.
Standing tasks
Beyond one-off messages, you can hand an agent a standing taskand let it run: “If ETH drops below $2,000, buy $200 worth,” or “rebalance back to 60/40 every Friday.” The agent watches, spends energy as it works, and acts only when its conditions are met — always inside the leash, until the key expires or you lock the wallet.
Always within your limits
An agent can never exceed the budget on its key, touch a contract outside its allow-list, or act after the key’s expiry. Change your mind at any moment: lock the wallet and every agent loses the ability to act in the same instant. You stay in control of the body; the agents only borrow it.
What agents cost
Agent work is paid for in two places. An agent’s thinking and the actions it runs consume energy ($1 per energy, roughly 100 messages). The on-chain transactions it sends also pay Base gas in ETH, plus a 1% fee on trades.