Offer

Offer

It runs on your own computer, on your own Claude. One install, once — and it stays yours.

1 Have Claude Code?

Copy this and paste it into Claude. It installs and starts everything for you — you type nothing.

You are setting up "Qiksy" on this computer for someone non-technical. Do it for them, one step at a time, in short plain sentences — no jargon. You can run shell commands.

1. Check Node.js: run `node -v`. If it is missing or older than v18, install it the simplest way for this OS and say in one line what you are doing (macOS: `brew install node`, and if Homebrew is missing install it from https://brew.sh · Windows: `winget install OpenJS.NodeJS.LTS` · Linux: the distro package manager). If a step needs their password or a click, tell them exactly what to do and wait.

2. Start the engine — this downloads it the first time and then keeps it running:
   `npx qiksy`
   Run it so it KEEPS RUNNING in the background; do not block on it. Then wait about 15 seconds.

3. Confirm it is up: fetch http://localhost:5544/api/engine and expect JSON. The same run also starts Travel on 5545 and Qiksy Deal on 5546 — check those only if the person asked about them.

4. When it is running, say exactly this and stop:
   "✅ Qiksy is running. Go back to your Qiksy tab in the browser — it connects on its own. Keep THIS window open while you use it."

If they ever want to stop it: `npx qiksy stop`. To check: `npx qiksy status`. If something is stuck: `npx qiksy restart`.

Rules: never delete or change files that are not part of this setup. If something fails, explain in one plain sentence what happened and what to try — do not paste raw errors.
2 No Claude Code yet?

Install it once (about two minutes), then come back and paste the prompt above.

Install Claude Code ↗
Turning it off, or fixing it

In the same window Claude opened, or any terminal:

  • npx qiksy stop turn everything off
  • npx qiksy status see what is running
  • npx qiksy restart if something is stuck
It is not working — what now?

It repairs itself in the background, so most things fix themselves. If something is still wrong, hand this to Claude and it will sort it out for you:

"Qiksy" is not working on this computer. You are fixing it for someone non-technical. Be brief and plain — no jargon, no raw error dumps. You can run shell commands.

1. Run `npx qiksy doctor` and read what it says. It reports Node.js, whether Claude Code is found, where the data folder is, and which of the three tools answer (Qiksy Offer 5544, Travel 5545, Qiksy Deal 5546).
2. Fix what it flags:
   · Node.js missing or older than v18 → install it (macOS `brew install node`, Windows `winget install OpenJS.NodeJS.LTS`, Linux the distro package manager).
   · A tool not running, or a port held by something else → run `npx qiksy restart`, wait 15 seconds, then `npx qiksy status`.
   · Still stuck → `npx qiksy stop`, wait 5 seconds, then `npx qiksy` and keep it running in the background.
3. If a port is held by an unrelated program, say which program it is in one sentence and ask them to close it. Never kill something you cannot identify.
4. Check the log at ~/.qiksy/engine.log (last 30 lines) only if it is still broken, and explain the cause in ONE plain sentence.
5. Finish with either "✅ Fixed — go back to your Qiksy tab" or one plain sentence saying what is wrong and that they can email [email protected].

Never delete their data: ~/.qiksy holds their candidates, trips and reports. Do not remove that folder.

Still stuck? Write to us — A real person answers — tell us what you saw and we will get you running. [email protected]

We'll connect the moment it's running — nothing else to do here.

One install runs all three tools: Qiksy Offer, Travel Assistant and Qiksy Deal.