@fre4x/jules

jules — The Coding Agent Bridge

Autonomous code changes, PR generation, and session management. The swarm's hands.

Part of FRE4X-B1TE — a monorepo of MCP servers built for autonomous agents.

Google Jules is an autonomous coding agent. This B1TE exposes its full API as MCP tools — so your agent can spawn Jules sessions, approve plans, and get PRs merged without a human in the loop.

Tools

Tool	What it does
jules_list_sources	List connected GitHub repos available as sources
jules_create_session	Start a new Jules coding session with a prompt, source, and optional config
jules_list_sessions	List all sessions and their status (e.g. PR links)
jules_approve_plan	Approve a session's execution plan (when requirePlanApproval=true)

jules_create_session parameters

Parameter	Type	Description
source	string	Source resource name, e.g. sources/github/owner/repo
title	string	Session title
prompt	string	Task description for Jules
startingBranch	string	Branch to start from (default: main)
automationMode	string	AUTO_CREATE_PR or NONE (default: NONE)
requirePlanApproval	boolean	If true, pause for jules_approve_plan before executing (default: false)

Requirements

A Jules API key — set as JULES_API_KEY.

Mock Mode

Run without an API key (returns fixture data of identical shape):

MOCK=true npx @fre4x/jules

Deploy

{
  "mcpServers": {
    "jules": {
      "command": "npx",
      "args": ["-y", "@fre4x/jules"],
      "env": {
        "JULES_API_KEY": "your_api_key_here"
      }
    }
  }
}

Development

npm install
npm run dev      # tsx, no build
npm run build    # esbuild → dist/
npm test         # vitest unit tests

License

MIT — WE ARE THE FRE4X.