FlowJet
🎥 Watch the demo video on Vimeo
FlowJet (flowjet-agent) is a one-shot coding-agent CLI for the terminal. Type a question, get an answer — no UI, no context-switching:
fj explain this repo # alias of flowjet-agent
fj -f what did we decide last time
fjf what did we decide last time # alias of fj -f
It runs on soothe-nano — tools, skills, MCP, subagents, and progressive loading — with SQLite persistence so every thread is resumable.
Package / formal CLI: flowjet-agent · aliases: fj, fjf (=
-f) · Runtime: soothe-nano · Repo: flowjet-agent
See docs/naming.md for the formal naming model.
Install
pip install flowjet-agent
# or
uv tool install flowjet-agent
Requires Python 3.11+.
Configure
Option A — Local model (guided):
fj setup
Walks you through an OpenAI-compatible endpoint (Ollama, LM Studio, vLLM, …) and writes the basics to ~/.soothe/config/nano.yml.
Option B — Cloud (no config file):
export OPENAI_API_KEY=sk-...
fj summarize README.md
Missing nano.yml falls back to OPENAI_API_KEY or ANTHROPIC_API_KEY.
Doctor
Check whether this machine can run fj (tool binaries, providers, observability).
Requires soothe-nano with the diagnose API (1.0.8+):
fj doctor
fj doctor --deep
fj doctor --live-llm
fj doctor --format json
Run
fj who are you
fj list Python files in this directory
fj refactor the parser to use dataclasses
Conversation
Threads persist across runs in SQLite. Continue the latest, jump to a specific one, or list them:
fj -f and now add tests # continue latest active thread
fj -t abc123 continue from here # continue a specific thread
fj -l # list recent threads
Flags
fj [options] [--] <query...>
| Flag | Meaning |
|---|---|
-f / --follow |
Continue the latest active thread |
-t ID / --thread |
Continue (or pin) a specific thread (overrides -f) |
-l / --list |
List recent threads (newest first) |
-n NUM |
How many threads -l shows (0 = all) |
-c PATH / --config |
Use an alternate nano.yml |
-w DIR / --workspace |
Workspace root |
--no-stream |
Wait for the full answer instead of streaming |
-v / --verbose |
Mirror tool calls on stderr |
-tand-fmay be used together;-twins (explicit id overrides follow).
Shell completion (AI-assisted, predicts natural-language intents, not just flags):
eval "$(fj completion zsh)" # or: fj completion bash
Extend
Skills
fj ships AgentSkills (planning, TDD, debugging, document tools, MCP builder, and more) and supports your own via nano.yml:
skills:
- ~/.soothe/skills/my-reviewer
- ./skills/deploy
Each skill is a SKILL.md with frontmatter; progressive loading keeps the catalog compact and loads on demand.
MCP servers
Connect any Model Context Protocol server:
mcp_servers:
- name: filesystem
transport: stdio
command: npx
args: ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
With defer: true (default), MCP tools activate on demand.
Development
git clone https://github.com/caesar0301/flowjet-agent.git
cd flowjet-agent
make sync-dev
make test
make lint
CI runs format, lint, and tests on Python 3.11–3.13; releases go GitHub Release → PyPI.
Powered by
Built on soothe-nano. For a full TUI coding agent from the same stack, see mirasoth/soothe.
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file flowjet_agent-1.0.28.tar.gz.
File metadata
- Download URL: flowjet_agent-1.0.28.tar.gz
- Upload date:
- Size: 1.2 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b31c01cd4017c559104b856f670df6bff536c17043ae91bc7889a7152b404413
|
|
| MD5 |
4fa282b0a751ee544b98f07b0f3e43cd
|
|
| BLAKE2b-256 |
33d30d3588c9d39490e646fb5541d335620c0a6e73d55e3cd8d6271f8eb5f433
|
File details
Details for the file flowjet_agent-1.0.28-py3-none-any.whl.
File metadata
- Download URL: flowjet_agent-1.0.28-py3-none-any.whl
- Upload date:
- Size: 1.4 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4b940cbe51522ef8f79e3ef0a340681cf95657e610c3a395f9ffb4a032461937
|
|
| MD5 |
afa4808a7e2abeda10921cab4831248c
|
|
| BLAKE2b-256 |
557c79ca73eb418d2c4e885d01d85bb4110442cad5f4f0fc0f1435e20900ad98
|
