myrmidocs (CLI: myr)

AI-first self-hosted knowledge base and startup OS. All content lives as markdown files on disk. Humans define intent. Agents do the work. The knowledge base is the shared memory between both.

Quick Start

mkdir my-startup && cd my-startup
npx myr run

That's it — no global install needed. run bootstraps the directory, auto-downloads the app on first use, installs dependencies, and opens in your browser.

What You Get

• WYSIWYG markdown editor with AI editing panel (Claude)
• Agent dashboard — define personas, run tasks, view transcripts
• Scheduled jobs — cron-based automation with YAML configs
• Kanban task board
• Full terminal in the browser (xterm.js)
• Cmd+K search across all pages
• Git-backed version history with one-click restore
• Drag-and-drop page organization
• Myrmidocs registry — import pre-made templates for SaaS, agencies, e-commerce, and more

How It Works

~/.polymyr/              Global app cache (auto-managed)
  app/v0.3.0/            Version-pinned Next.js install

~/my-startup/            Your polymyr (this is your data)
  .polymyr               YAML manifest
  .agents/               Agent personas
  .jobs/                 Scheduled jobs
  index.md               Entry page
  ...                    Your content

The app lives in ~/.polymyr/ and is shared across all your polymyrs. Each polymyr is a lightweight directory you can put anywhere — just a .polymyr manifest file, your agents, jobs, and content. No database.

Commands

All commands work via npx — no global install needed.

npx myr create [name]

Create a new polymyr directory.

npx myr create my-startup          # root polymyr
cd my-startup
npx myr create engineering         # child polymyr inside an existing one

npx myr run

Start Myrmidocs serving the current directory.

npx myr run
npx myr run --no-open              # don't open browser
npx myr run --app-version 0.2.12   # use a specific app version

On first run, downloads the app to ~/.polymyr/app/ and installs dependencies. If the current directory is not already a polymyr, run bootstraps it in place by creating the .polymyr, .agents/, .jobs/, and .polymyr-state/ structure before starting the server.

Environment variables:

| Variable | Default | Description | |---|---|---| | POLYMYR_APP_PORT | 4000 | App server port | | POLYMYR_DAEMON_PORT | 4100 | Daemon server port |

npx myr import <template>

Import a pre-made polymyr from the template registry.

npx myr import saas-startup
npx myr import career-ops
npx myr import text-your-mom

npx polymyr polymyrs

List all polymyrs in the current directory.

npx polymyr polymyrs

  Name              Kind    Path              Agents  Jobs
  My Startup        root    .                 3       2
  Engineering       child   engineering       2       1

npx myr search / read / list

Read-only grounding commands for headless agents, served by the running daemon. Auth from POLYMYR_DAEMON_TOKEN or <dataDir>/.agents/.runtime/daemon-token; daemon URL from POLYMYR_DAEMON_URL (default http://127.0.0.1:4100).

npx myr search "quarterly goals" --limit 10   # cited hits: path:line + context
npx myr read strategy/roadmap                 # raw markdown, frontmatter included
npx myr list strategy                         # path<TAB>title<TAB>modified rows

Exit codes: 0 ok, 1 search found nothing, 2 error. There is no write subcommand.

npx myr doctor

Run health checks on the environment.

npx myr doctor
npx myr doctor --fix       # attempt auto-repair

Checks Node.js version, polymyr structure, app installation, dependencies, and port availability.

npx myr update

Download a newer app version.

npx myr update

npx myr uninstall (alias: remove)

Remove cached app versions from ~/.polymyr/. Prints a summary of what will be deleted and asks for confirmation. Your polymyr directories and their data are never touched — those you'd delete manually.

npx myr uninstall          # remove cached app versions only
npx myr uninstall --all    # also remove global state and telemetry data
npx myr uninstall --yes    # skip the confirmation prompt
npx polymyr remove             # alias for uninstall

What --all removes:

| Path | What's there | |---|---| | ~/.polymyr/ | cached app versions, global state, config.json | | ~/Library/Application Support/polymyr-telemetry/ (macOS) | anonymous install_id, telemetry queue, session state | | %APPDATA%\polymyr-telemetry\ (Windows) | same as above | | $XDG_CONFIG_HOME/polymyr/ (Linux, falls back to ~/.config/polymyr/) | same as above |

To completely remove everything Myrmidocs has on your machine — including your polymyrs — run uninstall --all and then rm -rf your polymyr directories manually.

Requirements

• Node.js >= 18 (20+ recommended)
• git (for importing templates and app download fallback)

License

MIT