Skip to content

[#827] Update /agents Build tab — add OWS Writer guide #837

@realproject7

Description

@realproject7

Summary

Update the /agents Build tab to include a guide for the PlotLink OWS Writer — the local AI writing assistant that lets anyone become a fiction writer with just an idea. This should be the primary recommended path alongside the existing CLI instructions.

Repo & Branch

  • Work in: realproject7/plotlink (this repo)
  • Branch: task/825-agents-ows-writer-guide
  • PR closes: Fixes #825

Context

PlotLink OWS Writer (realproject7/plotlink-ows) is a local app where users:

  1. Connect their own LLM (Anthropic, OpenAI, Gemini, or Ollama)
  2. Get an OWS wallet (encrypted on their machine, private key never exposed)
  3. Chat with an AI co-writer to brainstorm, draft, and refine fiction stories
  4. Publish stories on-chain to PlotLink with one click

This is the simplest path for non-technical users to become writers on PlotLink.

Tasks

1. Restructure Build Tab

Current structure: CLI-only instructions.
New structure:

  1. OWS Writer (recommended) — AI writing assistant (new, primary)
  2. CLI — command-line tool (existing, secondary)
  3. llms.txt — machine-readable info (existing, keep as-is)

2. OWS Writer Section Content

Add as the first/primary section in AgentBuild.tsx:

Headline: "Write with AI — No coding required"
Subtitle: "Anyone can become a fiction writer with just an idea. The OWS Writer is a local app that pairs you with an AI co-writer to brainstorm, draft, and publish tokenized stories."

How it works (visual steps):

  1. Install & run the app on your computer
  2. Connect your LLM (Anthropic, OpenAI, Gemini, or local models)
  3. Chat with your AI writer — brainstorm ideas, refine drafts
  4. Publish — the AI uploads to IPFS and signs the on-chain transaction via OWS
  5. Earn 5% royalties on every trade of your story token

Quick start code block:

git clone https://github.com/realproject7/plotlink-ows.git
cd plotlink-ows
npm install
npm run app:dev

Then open http://localhost:7777

Key features (bullet points):

  • Your private key stays encrypted on your machine (OWS wallet)
  • Bring your own LLM — no API key shared with PlotLink
  • Stories published to IPFS + Base blockchain
  • Every story deploys a bonding curve automatically

Link: "View full docs → github.com/realproject7/plotlink-ows"

3. Update CLI Section

  • Move CLI section below OWS Writer
  • Add note: "For developers and automated agents. For a guided writing experience, use the OWS Writer above."
  • Keep existing CLI content as-is

4. Visual Design

  • Follow existing AgentBuild.tsx component patterns
  • OWS Writer section should feel more inviting/approachable than the CLI section
  • Use existing PlotLink design tokens (border-border, bg-surface, text-foreground, text-accent)
  • Consider a simple diagram or icon for the "How it works" steps

Acceptance Criteria

  • OWS Writer section is the first/primary section on the Build tab
  • Quick start instructions with git clone + npm commands
  • "How it works" steps clearly explain the flow
  • CLI section still present but secondary
  • Existing llms.txt link still works
  • Design consistent with rest of /agents page

Metadata

Metadata

Assignees

No one assigned

    Labels

    agent/T3Assigned to T3 builder agentdesignDesign and UI changeshackathon/owsOWS Hackathon submissionphase/6-agentsPhase 6: Agent Layer

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions