instant decision making instrument

a traffic light for your own thoughts.

jiko is a small physical signal instrument. it listens to one spoken intention, separates it into three independent readings — content, emotion, context — then reveals whether the readings agree or diverge. it does not tell you what to do. the final choice stays with you.

pre-release · v0.9 · hardware in design · software prototype functional · site live

When every AI rushes to give you an answer, jiko refuses — it splits your thought into three signal lights, and leaves you to read them.

In an age of too many answers, restraint is radical.

• not an AI assistant.
• not a decision recommendation engine.
• not a therapy chatbot or fortune-telling machine.
• not a traffic light that says stop / go.

the device can reveal signal, disagreement, or unanimity. but the interpretive step belongs to the person.

1. hold the side button.
2. speak one intention — "I'm thinking about quitting" or "I may not go tonight."
3. three windows animate independently; each locks into a signal state.
4. the top strip shows a short observation.
5. the device speaks one line, then stops.

the silence after speech is part of the product. it gives the decision back.

• maintain — the reading sees inertia, a return to the familiar path.
• deviate — the reading sees rupture, movement, a break from pattern.
• static — the reading cannot form a stable signal.

color mapping: red · yellow · green. never good / bad / correct / wrong.

a thick vertical slab — masked four-window shell, side thumb button. the prototype runs on Raspberry Pi 5 with MPI3508 display, but the product form is independent of any specific compute board. the interaction is quieter and stranger than an assistant.

current industrial design uses superellipse (squircle) corner geometry. see docs/form-factor.md and docs/hardware-notes.md.

• https://jiko.ptoq.io/ — canonical public website.
• https://jiko-showcase.vercel.app/ — Vercel fallback / frontend deployment URL.
• /?mode=device — the kiosk face. the actual instrument.
• showcase.html — a standalone Three.js hardware-material study.
• site.html — the public first-viewport, embedding the hardware object in a quiet framed page.

same product language, no shared fake runtime paths.

pnpm install
pnpm dev:server
pnpm dev:web
pnpm demo:urls

trigger a reading without audio:

curl -X POST http://localhost:4317/sessions \
  -H 'content-type: application/json' \
  -d '{"sessionId":"demo-001","source":"manual"}'

curl -X POST http://localhost:4317/sessions/demo-001/manual-transcript \
  -H 'content-type: application/json' \
  -d '{"transcript":"I am thinking about quitting, but I still want to say this clearly first.","language":"en"}'

• Product Brief
• Engineering Discipline
• Engineering Architecture
• Backend Architecture
• Runtime Paths
• Audio Prototype
• Data Handling
• Result Copy
• Form Factor
• Hardware Phases
• Hardware Notes
• Hardware Interfaces
• Showcase Design Decisions
• Waitlist Deploy
• Demo Runbook
• Repository Map
• Release Versioning
• Next Phase Checklist
• Open Questions

this is an open hardware-design workflow. issues, questions, and design discussions are welcome.

https://github.com/p-to-q/jiko/issues

CC BY-NC-SA 4.0. you can read, learn, fork, and contribute — but not commercialize.

a p to q project.