rscot-agent
v1.2.3
Published
Rscot Agent (rscot) — local-first, source-available coding agent. One-shot npx onramp that walks you through provider/key setup.
Maintainers
Readme
rscot-agent
One-shot onboarding for Rscot Agent — local-first, source-available coding agent. Pick a provider, paste a key, you're done.
What it does
npx rscotIn about 60 seconds:
- Probes your environment — node, python, git, ripgrep, ollama, existing provider keys in env
- Picks an LLM provider — DeepSeek (default), OpenAI, Anthropic, OpenRouter, Ollama (more in the desktop app + VSCode extension)
- Pastes your key — masked input, written to
~/.rscot/keys/<provider>.keywithchmod 600 - Writes config —
~/.rscot/config.json, prints next commands
The agent brain (FastAPI backend, tool-use loop, knowledge layer) and execution shell (desktop app / VSCode extension) install separately — this package is just the front door.
Install
One-shot via npx (recommended):
npx rscotOr install globally:
npm i -g rscot-agent
rscotCLI
rscot run the interactive onboarding flow
rscot --version print version
rscot --help print help
rscot --no-prompt env probe only (CI-safe smoke test)What gets written
| Path | Mode | What |
| ------------------------------- | -------- | ------------------------------------------ |
| ~/.rscot/config.json | 0600 | Provider, model, env-var name, install ts |
| ~/.rscot/keys/<provider>.key | 0600 | API key (only if you pasted one) |
Override the config root with RSCOT_HOME=/some/path before launch.
Uninstall
rm -rf ~/.rscot
npm uninstall -g rscot-agent # if installed globallyRemoves config + every stored key.
Privacy & security
- Keys live only on your disk —
~/.rscot/keys/<provider>.key,chmod 600, never transmitted by this package - No telemetry — this CLI never phones home; runs fully offline after the npm install
- Pasted keys are masked during input; nothing is echoed or written to shell history
Companion installs
- Desktop app (learningfind.com/install) — full multi-window flow + 11-provider catalog
- VSCode extension —
code --install-extension recot.rscot-agent— sidebar inline with your editor
Sessions sync across desktop + VSCode via the local backend.
License
Source-available under RSANC-1.0 — free for personal, academic, non-profit, and 90-day evaluation use. Commercial use requires a separate license from [email protected].
