Skip to content
Nireus79Public

About

No description, website, or topics provided.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Μώλυ — Socratic Communication Coach

Better thinking before you hit send. Moly asks the one question that matters, then helps you write. It never decides for you.

Moly is a browser extension (Chrome, Edge, Brave) with a small app on your computer. It is free and open source (MIT): no account, no analytics, no tracking, no advertising network (a small card with a message from Moly or a sponsor may appear in its own area below the writing box; it can be hidden until Moly is opened again). Your conversations are stored only on your machine, encrypted. It uses a model on your computer (Ollama) or your own Claude or OpenAI key, which you can protect with a passphrase.

Get it: the extension from the Chrome Web Store (link here when listed) and the app from the releases page; step by step in INSTALL.md. Website and privacy policy: nireus79.github.io/Moly (set up with GitHub Pages from the site/ folder).

Support: Moly is free. If it helps you, please sponsor the project.

Status: beta. The Linux installer is tested; the Windows installer is tested only under Wine; the Mac installer has never run on a Mac. Problems and questions: Hermes_creative@proton.me or the issues page. Moly is a writing coach, not a crisis, medical or legal service.


What Moly does

  • Asks before it writes. If something that blocks your goal is missing (who the person is, what you want), Moly asks one question per reply, optionally after one short sentence of what it understood.
  • A way out. Once you have answered at least one question, a Skip questions button lets you take the result with what is known. Skipped questions are kept as pending and come back, ranked against new gaps, if you keep working on the same goal. A clear request with no gaps and no risk is simply answered.
  • Safety without strictness. An unclear message is never a crisis. Moly asks first. Clear harm (self-harm, illegal acts) gets a short refusal with no help lines: "I can't help with that. Please consider asking advice from a specialist." (a law expert for illegal requests).
  • Doubt means ask. A person or goal the model is not sure of is not saved; Moly confirms it with one question. A goal must be quoted from your own words.
  • Reflective questions (Socratic) only when a model judgement says the situation has something you may not have thought through, and never before you have answered a question.
  • Your values. Six principles in moly-go/config/constitution.yaml guide the questions.

How it works (short)

Every message goes through fixed stages: safety → intent and goal → identity (the one place a person is saved) → gaps and conflicts → one reply decision → one transaction commit. Maturity is a single number: answered questions over answered plus open ones. Details: docs/ARCHITECTURE.md.

Quick start (for developers)

For users, see INSTALL.md. To build from source:

git clone https://github.com/Nireus79/Moly.git
cd Moly/moly-go && go build -o ../bin/moly .         # Go and a C compiler (SQLCipher)
cd ../moly-extension && npm install && npm run build  # load moly-extension/dist unpacked
../bin/moly --register-host --extension-ids <extension id>   # lets the browser start the app

Development mode (no registration): run ../bin/moly by hand (port 11436, Ollama on :11434). Details and the other systems: INSTALL.md.

Try it

scripts/live_chat.sh      # you type every message; shows canSkip and the stage markers
scripts/live_check2.sh    # rule checks against the live model (A–F)
cd moly-go && go test -count=1 ./...   # the scripted suite

Documentation

docs/ORCHESTRATOR_DESIGN.md Design, decisions, live findings (authoritative)
docs/ARCHITECTURE.md Stages, data flow, where things live
docs/API.md REST API
docs/DEVELOPMENT.md Build, test, live checks
docs/MOLY_COMPLETE_VISION.md Product vision
docs/LOGGING_GUIDE.md Logs (no message text or email is logged)
CLAUDE.md Guide for Claude Code sessions
CONTRIBUTING.md Contributing
docs/archive/ Earlier plans, reports and superseded specs

Privacy

Stored per user in an encrypted SQLite database on your machine (key in the OS keychain, or protected by your passphrase where there is none): full chat history (needed to resume), contacts, questions and profile. Logs hold no message text or email. Deleting a profile removes every row that belongs to the user, and the file is compacted afterwards (TestDeleteUserLeavesNothingInAnyTable).

What leaves your machine: with a local Ollama model, nothing. If you choose Anthropic or OpenAI with your own API key, the text of each turn is sent to that provider to write the reply. Moly has no server of its own and collects nothing.

You can download everything Moly stored about you (Settings, "Export my data") and delete it all. The installed app listens on this computer only and requires a per-run token; details, known gaps and the full audit: docs/PRIVACY.md.

License

MIT — see LICENSE.

About

No description, website, or topics provided.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages