@skastr0/quasar-cli 0.1.1 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +35 -9
  2. package/package.json +7 -5
package/README.md CHANGED
@@ -1,12 +1,11 @@
1
1
  # Quasar CLI
2
2
 
3
- The Quasar CLI discovers and parses local AI agent session histories,
4
- read-only.
3
+ The Quasar CLI discovers, parses, ingests, and queries local AI-agent session
4
+ histories.
5
5
 
6
- Status: pre-release. Only local commands exist today (doctor, capabilities,
7
- schema, examples, sources discover). Ingest, search, and session reads arrive
8
- with the v2 server (see `docs/architecture/quasar-v2-greenfield-plan-2026-06-10.md`
9
- in the repository).
6
+ The production control surface is the Effect local server with SQLite truth,
7
+ durable worker queues, and LanceDB search. The npm package ships that production
8
+ CLI as a prebuilt Bun standalone binary behind a small Node launcher.
10
9
 
11
10
  ## Install
12
11
 
@@ -24,7 +23,34 @@ pnpm --package @skastr0/quasar-cli dlx quasar --help
24
23
  ```
25
24
 
26
25
  The npm package ships a Node launcher plus prebuilt Bun standalone binaries for
27
- macOS and Linux on arm64/x64. The Convex control app and dashboard are not
28
- published to npm.
26
+ macOS and Linux on arm64/x64.
29
27
 
30
- Local discovery commands are read-only against native agent history folders.
28
+ ## Connect to a Mac mini Quasar server
29
+
30
+ Use the Mac mini's direct Tailscale IP, not MagicDNS, as the proof boundary:
31
+
32
+ ```bash
33
+ export QUASAR_LOCAL_SERVER_URL=http://<mac-mini-tailscale-ip>:6180
34
+ export QUASAR_INGEST_TOKEN=<same-token-configured-on-the-mac-mini-server>
35
+
36
+ quasar stats
37
+ quasar search --mode fusion --query "quasar local server" --limit 3
38
+ quasar ingest --provider all --summary
39
+ quasar workers
40
+ ```
41
+
42
+ `ingest` reads native local history folders on the machine running the CLI and
43
+ POSTs mapped sessions to the configured server. The server owns idempotent SQLite
44
+ writes, embedding cache lookup, and search-index queue draining.
45
+ Remote ingest requires `QUASAR_INGEST_TOKEN` or `--ingest-token <token>`; read
46
+ and search commands do not.
47
+
48
+ Override provider roots when needed:
49
+
50
+ ```bash
51
+ export QUASAR_CODEX_ROOT="$HOME/.codex"
52
+ export QUASAR_CLAUDE_ROOT="$HOME/.claude"
53
+ export QUASAR_OPENCODE_ROOT="$HOME/.local/share/opencode"
54
+ export QUASAR_GROK_ROOT="$HOME/.grok"
55
+ export QUASAR_HERMES_ROOT="$HOME/.hermes"
56
+ ```
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@skastr0/quasar-cli",
3
- "version": "0.1.1",
3
+ "version": "0.1.3",
4
4
  "description": "Command line importer and client for Quasar AI agent sessions.",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -27,16 +27,18 @@
27
27
  "scripts": {
28
28
  "dev": "bun run ./src/cli.ts",
29
29
  "build": "bun build --compile ./src/cli.ts --outfile ./dist/quasar",
30
+ "install:dev": "bun scripts/install-dev.mjs",
31
+ "install:local": "bun run install:dev",
30
32
  "build:npm-packages": "bun scripts/build-npm-packages.mjs",
31
33
  "pack:dry-run": "npm pack --dry-run",
32
34
  "typecheck": "tsc --noEmit",
33
35
  "test": "bun test"
34
36
  },
35
37
  "optionalDependencies": {
36
- "@skastr0/quasar-cli-darwin-arm64": "0.1.1",
37
- "@skastr0/quasar-cli-darwin-x64": "0.1.1",
38
- "@skastr0/quasar-cli-linux-arm64": "0.1.1",
39
- "@skastr0/quasar-cli-linux-x64": "0.1.1"
38
+ "@skastr0/quasar-cli-darwin-arm64": "0.1.3",
39
+ "@skastr0/quasar-cli-darwin-x64": "0.1.3",
40
+ "@skastr0/quasar-cli-linux-arm64": "0.1.3",
41
+ "@skastr0/quasar-cli-linux-x64": "0.1.3"
40
42
  },
41
43
  "devDependencies": {
42
44
  "@effect/cli": "^0.75.0",