Seed Network Agent

seed is a terminal agent for Seed Club network members — an angel investing partner that runs in your terminal. It helps you build your investing worldview, research and evaluate companies, work deals, and keep a private knowledge base of your theses, opinions, and sources — all connected to your Seed Network account.

It is built on the Pi agent runtime, but it is not a coding assistant: coding tools and shell access are disabled, and every capability is scoped to the Seed Network.

Requirements

• Node.js 22 or newer
• A model provider login — a ChatGPT Plus/Pro subscription is the best option right now, api key to OpenAI or Anthropic also works.
• A Seed Network account to connect the agent to

Install

npm install -g @seed-network/agent
seed

First run

seed shows three explicit setup steps the first time you run it.

1. Connect a model. Run /login and pick a provider. Connecting a ChatGPT Plus/Pro subscription is the best option right now.

   If you'd rather use an API key, /login supports OpenAI, Anthropic, and other configured providers.

   Credentials are stored under ~/.seed-network-agent/

2. Connect your agent. Run /connect, approve the connection in your browser, then return to the terminal. Model setup never opens this connection for you automatically.

3. Personalize and hatch your agent. Run /personalize to connect X and give your agent useful starting context about who you are and what has your attention. The facts and source material are saved privately to Notes, then the normal Seed Network Agent takes over the conversation—there are no more onboarding tasks.

From there, just start talking. Share a link, name a company, work through a market — the agent captures investing-relevant signal to your private notes as you go and connects new input to what you've saved before.

What you can do

• Explore and build your worldview. Conversations are the default mode: the agent relates companies, markets, and theses to your prior notes and the network's shared knowledge base, and quietly accumulates your opinions and sources.
• Research companies. /research-company runs a cited public-source research process; /add-company starts a detached job that researches a company, publishes its page to the Seed Network companies wiki, verifies it, and generates analysis while the foreground remains conversational.
• Work deals. /create-deal builds a deal draft from a pitch deck PDF (interpreted in the background); /submit-deal submits it to Seed Network when you're ready.
• Keep private notes. /notes-search, /notes-ingest, and /notes-curate-session manage your private knowledge base — distinct from the shared network knowledge base, which you can contribute to with /knowledge-base-ingest.

Commands

Run /seed-help inside the agent for the full, current list. Highlights:

| Command | What it does | | --- | --- | | /login | Connect a model provider using a subscription or API key. | | /connect | Connect the agent to your Seed Club account. | | /personalize | Connect X and hatch your personalized agent. | | /seed status | Show the agent's Seed Club connection status. | | /disconnect | Log this local agent out of Seed Club. | | /research-company <name \| url> | Run public-source research and return a cited dossier. | | /add-company <url> | Research a company and create its page in the companies wiki. | | /tasks | List recent background jobs and their stages. | | /task <job-id> | Inspect a background job's progress and outcome. | | /cancel-task <job-id> | Cancel one queued or running background job. | | /analyze-company <name> | Generate or refresh the AI analysis for a company page. | | /create-deal | Create a deal draft from a PDF pitch deck. | | /submit-deal | Submit the active deal draft to Seed Network. | | /clear-deal | Clear the active deal context for this session. | | /notes-search <query> | Search your private notes. | | /notes-ingest <url> | Save a URL into your private notes with source provenance. | | /notes-curate-session | Distill durable learnings from the current conversation into your notes. | | /knowledge-base-ingest <file-or-url> | Contribute a source to the shared network knowledge base. | | /flag [reason] | Something off? Send the transcript to the Seed team for review. |

Pi's built-in session commands (/model, /reload, /trust, session switching) also work.

Updating

The CLI checks npm for updates at startup (at most once per day) and prints the exact update command when a newer version is available. To update manually:

npm install -g @seed-network/agent@latest

Updating the bundled Pi runtime (maintainers)

From the repository root, update all three Pi runtime packages together to their latest versions while keeping them pinned exactly:

pnpm agent:update-pi

After updating, build and test the agent before publishing a new release:

pnpm --filter @seed-network/agent build
pnpm --filter @seed-network/agent test

Where your data lives

Everything is stored under ~/.seed-network-agent/ — model credentials, sessions, and Seed connection grants. This is fully separate from any existing pi install, so the two never share config or credentials.

Troubleshooting

A tool fails with "Agent does not have an active grant for capability <name>" (or a 403). Your agent version added a capability your existing connection hasn't approved yet. Run /connect once and finish connecting the agent through the browser. No need to /disconnect first. Check current status with /seed status.

Something else went wrong or the agent behaved badly. Run /flag with a short reason — it sends the transcript to the Seed Network team for review.