Alexandria Outpost

A local UI for browsing Alexandria repository documentation. Run Alexandria locally and connect to either the remote registry or your own local repository registry.

Installation

npm install -g @a24z/alexandria-outpost

Or use directly with npx:

npx @a24z/alexandria-outpost serve

Usage

Basic Usage

Start the Alexandria UI locally:

alexandria-outpost serve

This will:

• Start a local server on port 3003
• Open your browser automatically
• Connect to the default Alexandria API at https://git-gallery.com

Command Options

alexandria-outpost serve [options]

Options:
  -p, --port <port>     Port to run the server on (default: 3003)
  --api-url <url>       Alexandria API URL (default: https://git-gallery.com)
  --no-open            Do not open browser automatically
  -h, --help           Display help

Examples

Run on a different port:

alexandria-outpost serve --port 8080

Connect to a local API server:

alexandria-outpost serve --api-url http://localhost:3002

Run without opening browser:

alexandria-outpost serve --no-open

Integration with Memory Palace

Alexandria Outpost is designed to work seamlessly with the Memory Palace CLI. When Memory Palace implements local registry support, you'll be able to:

# Future Memory Palace integration
memory-palace alexandria serve
memory-palace alexandria scan ./repos
memory-palace alexandria add /path/to/repo

Environment Variables

You can also configure the outpost using environment variables:

PORT=8080 ALEXANDRIA_API_URL=http://localhost:3002 alexandria-outpost serve

Development

To build from source:

git clone https://github.com/a24z-ai/alexandria.git
cd alexandria
npm install
npm run build:ui -- --config astro.config.outpost.mjs
node scripts/build-server.js
node dist/cli.js serve

License

MIT © a24z

Links

• Alexandria Repository
• Memory Palace
• a24z Memory