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:

flowjet-agent explain this repo
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
`-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

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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

flowjet_agent-1.0.23.tar.gz (1.2 MB view details)

Uploaded Jul 31, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

flowjet_agent-1.0.23-py3-none-any.whl (1.4 MB view details)

Uploaded Jul 31, 2026 Python 3

File details

Details for the file flowjet_agent-1.0.23.tar.gz.

File metadata

Download URL: flowjet_agent-1.0.23.tar.gz
Upload date: Jul 31, 2026
Size: 1.2 MB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for flowjet_agent-1.0.23.tar.gz
Algorithm	Hash digest
SHA256	`9b3cae9432cb2e6ba118e8e70dadca9cfec636dfdac9f1a6317165fafea81e25`
MD5	`7d0e8a6c44bea117a5215d292b6af730`
BLAKE2b-256	`a886b1b41df785b3f155b955c6bca42e529aafb4da7d0ed3dbae35cc84308c6f`

See more details on using hashes here.

File details

Details for the file flowjet_agent-1.0.23-py3-none-any.whl.

File metadata

Download URL: flowjet_agent-1.0.23-py3-none-any.whl
Upload date: Jul 31, 2026
Size: 1.4 MB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for flowjet_agent-1.0.23-py3-none-any.whl
Algorithm	Hash digest
SHA256	`48da55067dcd2183c2c686695b73879e46b06e29a2b893b150abd025b7e4d171`
MD5	`7954ed3535d22cbed7fb09e5188880d9`
BLAKE2b-256	`68f476bceffca9cac5346e2f11b84d6ad89216c31e611b091c7b98aa49faafce`