Everything you need to install, configure, and use Symposia — the package manager for AI coding agent instructions.
$ npm install -g symposia
Run this in any project directory. It creates a .symposia/ folder and sets up your configuration.
$ sym init
Done. Symposia initialized.
Install instruction packages to give your AI coding agent specific capabilities.
$ sym add sym-tdd sym-refactoring
Installed 2 packages.
sym initInitialize Symposia in current directorysym loginAuthenticate with the registrysym logoutLog out of the registrysym registerRegister on the registrysym whoamiShow current identitysym add <package>Install a packagesym install <package>Install a package (alias for add)sym remove <package>Uninstall a packagesym listShow installed packagessym show <package>Show package detailssym search [query]Search available packagessym syncResync all package filessym update-packages [packages]Update packages to latestsym outdatedCheck for outdated packagessym generate --topic <topic>Generate a package from conventionssym create-package <name>Create a new packagesym publishPublish to git repositorysym invite createCreate an organization invitesym join <code>Join an organizationsym updateUpdate the CLI to latest versionSymposia supports three ways to reference packages when installing.
Install by short name from the Symposia registry.
sym add sym-tddReference a specific repository and optional version tag.
sym add github:user/repo@1.0.0Use a full GitHub URL directly.
sym add https://github.com/user/repoAfter running sym init, your project contains a .symposia/ directory with your installed packages and configuration.
.symposia/
registry.yml# installed packages manifest
docs/# package instruction files
overrides/# local customizations
Use symposia-config.yml in your project root to configure custom package sources, default behaviors, and team-specific settings.