Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion LICENSE.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# License

Create Seamless ("create-seamless) is licensed under the **GNU Affero General Public License v3.0 (AGPL-3.0-only)**.
Seamless CLI ("seamless-cli") is licensed under the **GNU Affero General Public License v3.0 (AGPL-3.0-only)**.

- SPDX: `AGPL-3.0-only`

Expand Down
60 changes: 52 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
# create-seamless
# Seamless CLI

[![License: AGPL-3.0-only](https://img.shields.io/badge/License-AGPL3-yellow.svg)](LICENSE)
[![npm version](https://img.shields.io/npm/v/create-seamless.svg?style=flat)](https://www.npmjs.com/package/create-seamless)
[![npm version](https://img.shields.io/npm/v/seamless-cli.svg?style=flat)](https://www.npmjs.com/package/seamless-cli)

`create-seamless` is a CLI for bootstrapping applications with Seamless Auth, an open source, passwordless authentication system.
Seamless CLI is a command-line tool for bootstrapping applications with Seamless Auth, an open source, passwordless authentication system.

It guides you through creating a fully working authentication stack with a web app, API, and auth server that are already connected and ready to run.

Expand All @@ -14,13 +14,13 @@ It guides you through creating a fully working authentication stack with a web a
Run the CLI with `npx`:

```bash
npx create-seamless my-app
npx seamless-cli init my-app
```

Or run it in your current directory:

```bash
npx create-seamless
npx seamless-cli init
```

You’ll be guided through a short setup process where you can choose:
Expand Down Expand Up @@ -122,7 +122,7 @@ npm run dev

## What is configured for you

create-seamless handles the parts that are usually difficult to get right:
Seamless CLI handles the parts that are usually difficult to get right:

- Shared API service tokens
- JWT signing configuration
Expand All @@ -136,7 +136,7 @@ Everything is aligned across services so the system works immediately after setu

## Included projects

create-seamless pulls from the following repositories:
Seamless CLI pulls from the following repositories:

- Seamless Auth API
[https://github.com/fells-code/seamless-auth-api](https://github.com/fells-code/seamless-auth-api)
Expand Down Expand Up @@ -169,7 +169,7 @@ Seamless Auth is built around a few principles:
- Production-shaped local development
- Explicit configuration over hidden behavior

create-seamless exists to make this setup fast and repeatable.
Seamless CLI exists to make this setup fast and repeatable.

---

Expand All @@ -181,6 +181,50 @@ create-seamless exists to make this setup fast and repeatable.

---

## Testing local CLI changes

From the repository root, build the CLI and link the local package:

```bash
npm install
npm run build
npm link
```

Then run the linked command:

```bash
seamless --version
seamless --help
```

When you are done testing, remove the global link:

```bash
npm unlink -g seamless-cli
```

To smoke test the package artifact before publishing:

```bash
npm run build
TARBALL=$(npm pack --pack-destination /tmp)
TEST_DIR=$(mktemp -d)

cd "$TEST_DIR"
npm install "/tmp/$TARBALL"
npm exec -- seamless --version
npm exec -- seamless --help
```

If npm cache permissions block local testing, use a writable temporary cache:

```bash
npm --cache /tmp/npm-cache exec -- seamless --version
```

---

## License

AGPL-3.0-only © 2026 Fells Code LLC
Expand Down
10 changes: 5 additions & 5 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

15 changes: 7 additions & 8 deletions package.json
Original file line number Diff line number Diff line change
@@ -1,19 +1,18 @@
{
"name": "create-seamless",
"version": "0.1.2",
"description": "The starter script for Seamless Auth",
"homepage": "https://github.com/fells-code/create-seamless#readme",
"name": "seamless-cli",
"version": "0.2.0",
"description": "The Seamless Auth command-line interface",
"homepage": "https://github.com/fells-code/seamless-cli#readme",
"bugs": {
"url": "https://github.com/fells-code/create-seamless/issues"
"url": "https://github.com/fells-code/seamless-cli/issues"
},
"repository": {
"type": "git",
"url": "git+https://github.com/fells-code/create-seamless.git"
"url": "git+https://github.com/fells-code/seamless-cli.git"
},
"license": "AGPL-3.0-only",
"author": "Fells Code, LLC",
"bin": {
"create-seamless": "dist/index.js",
"seamless": "dist/index.js"
},
"type": "module",
Expand Down Expand Up @@ -41,4 +40,4 @@
"tsx": "^4.21.0",
"typescript": "^5.9.3"
}
}
}
4 changes: 2 additions & 2 deletions src/commands/help.ts
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@ import { VERSION } from "../index.js";

export function printHelp() {
console.log(`
create-seamless v${VERSION}
seamless v${VERSION}

Seamless Auth CLI — scaffold and manage full-stack authentication systems.
Seamless CLI — scaffold and manage full-stack authentication systems.

────────────────────────────────────────────

Expand Down