Jules vs OpenCodeComparisonUpdated 2026-03-16
SUMMARY
Jules (Agent) uses markdown configuration while OpenCode (CLI) uses markdown. They differ on 2 of 11 compared features. Both tools provide AI-assisted development but take different approaches to project configuration.
FEATURE COMPARISON
| Feature | Jules | OpenCode |
|---|---|---|
| Config format | markdown | markdown |
| Hierarchy support | ✓ | ✓ |
| Global config | ✗ | ✓ |
| Project config | ✓ | ✓ |
| Subdirectory scoping | ✓ | ✓ |
| File inclusion / imports | ✗ | ✗ |
| Ignore file | ✗ | ✗ |
| IDE integration | Agent | CLI |
| Schema / structure | Free-form (Markdown) | Free-form (Markdown) |
| Git committed | ✓ | ✓ |
| Encoding | UTF-8 | UTF-8 |
FILE MAPPING
| Purpose | Jules | OpenCode |
|---|---|---|
| Project instructions | AGENTS.md | AGENTS.md |
| Project instructions | GEMINI.md | CLAUDE.md |
| Settings / configuration | .gemini/settings.json | opencode.json |
SIDE-BY-SIDE CODE SAMPLES
Jules
AGENTS.md
markdown
# Agent Instructions
## Project
A Django REST API serving a React frontend.
## Setup
- Python 3.12 with Poetry
- PostgreSQL 15
- Redis for caching and Celery broker
## Key Commands
- poetry run python manage.py runserver
- poetry run pytest
- poetry run mypy .
## Pull Request Guidelines
- Keep PRs focused on a single issue
- Add tests for all new functionality
- Update API docs in docs/api/ if endpoints change
- Run the linter: poetry run ruff check .
## Architecture Notes
- apps/core/ — shared models and utilities
- apps/api/v2/ — current API version
- apps/tasks/ — Celery background tasks
OpenCode
AGENTS.md
markdown
# Project Instructions
## Overview
This is a TypeScript monorepo using pnpm workspaces.
## Code Style
- Use strict TypeScript with no implicit any
- Prefer functional components with hooks
- All exports should be named (no default exports)
## Architecture
- /packages/core — shared business logic
- /packages/ui — React component library
- /apps/web — Next.js frontend
## Build & Test
Run tests with: pnpm test
Build all packages: pnpm build
All PRs must have >80% coverage on changed files.
## Conventions
- Use conventional commits (feat:, fix:, chore:)
- Prefer composition over inheritance
- See @docs/api-guidelines.md for API design patterns
KEY DIFFERENCES
Jules: Not supported. OpenCode: Supported.
Jules: Agent. OpenCode: CLI.
WHICH SHOULD I USE?
Choose based on your IDE/CLI preference. If you use Jules, configure AGENTS.md. If you use OpenCode, configure AGENTS.md. Many projects include config files for multiple tools so each team member can use their preferred editor.
PORTABILITY TIP
sync-instructions.sh
bash
# Maintain a single source of truth:
cp AI-INSTRUCTIONS.md CLAUDE.md
cp AI-INSTRUCTIONS.md .cursorrules
cp AI-INSTRUCTIONS.md AGENTS.md
SEE ALSO
agentconfig.ing2026-03-16COMPARE(1)