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.