Skip to main content

fj

A tiny coding agent with OpenRouter model support.

Quickstart

Create an OpenRouter API key and copy the environment template:

cp .env.example .env

Set OPENROUTER_API_KEY in .env, then run:

uv run fj

fj automatically reads .env from the current directory. Exported environment variables take precedence.

The default model is openrouter/free.

Other usage

uv run fj "Explain the agent loop in this repository"

uv run fj --resume

uv run fj --workspace examples/buggy_calculator --yolo \
  "Fix the failing tests and run them"

uv run fj --help

Interactive commands: /help, /reset, /exit. Ctrl-C stops the current turn. Ctrl-D exits.

What it can do

Tool Behavior
list_files Find files using a glob, such as **/*.py
read_file Read UTF-8 text with line numbers and a line range
search_files Search file contents for a literal string
write_file Create or overwrite a file after showing a diff
edit_file Replace one exact, unique piece of text after showing a diff
run_shell Run tests or commands, returning output and the exit code

The root AGENTS.md, if present, is included as project instructions.

Metadata

Release files for fj-agent 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for fj-agent 0.1.0
File Size Uploaded Provenance Actions
fj_agent-0.1.0.tar.gz 17.7 kB With provenance Details for fj_agent-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for fj-agent 0.1.0
File Interpreter ABI Platform Actions
fj_agent-0.1.0-py3-none-any.whl Python 3 none any Details for fj_agent-0.1.0-py3-none-any.whl

Total release size: 30.6 kB

Release files / fj_agent-0.1.0.tar.gz

Download URL fj_agent-0.1.0.tar.gz
Size 17.7 kB
Tags Source
SHA-256 checksum
How to use checksums
fbf6ae966a49021469c996314045bc66771922c007488f82ae2abd2da6338d65
BLAKE2b-256 checksum
How to use checksums
1e39829bfdf1c34c5e601b0800ea2b3beac3194e1aa28da8d06302a0c3ef9f85
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 6, 2026.

Transparency log

Release files / fj_agent-0.1.0-py3-none-any.whl

Download URL fj_agent-0.1.0-py3-none-any.whl
Size 12.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4ae2b967f22bfe4a5644d6eaf66bd1f0954c6f4cf802516815f80801f0f572ac
BLAKE2b-256 checksum
How to use checksums
25151e2d6d9965d47ff354bc68118d22623467d7361918047c0b54735a875ac8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 6, 2026.

Transparency log

Security for fj-agent 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for fj_agent-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 6, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page