The development environment for AI-powered open source contribution.
Osade is a new IDE built for contributing to open source with multiple coding agents working alongside you.
Today, contributing to an open-source project with AI often looks like this:
GitHub Issue
↓
Open terminal
↓
Start Claude / Codex
↓
Create a branch
↓
Monitor the agent
↓
Check what it changed
↓
Remember the project's conventions yourself
↓
Review everything
↓
Create PR
When working across multiple issues, repositories, and agents, this quickly becomes difficult to manage.
Osade is built to make this workflow a first-class experience.
Instead of treating an AI agent as a chatbot that edits your repository, Osade treats agents as workers inside a persistent development environment.
OSADE
│
┌─────────────┼─────────────┐
│ │ │
Worktrees Agents Memory
│ │ │
└─────────────┼─────────────┘
│
Open Source Work
│
┌──────────┴──────────┐
│ │
GitHub Repository
Issues Practices
PRs & Skills
You can work across multiple repositories, run multiple agents simultaneously, and keep everything inside one persistent environment.
Agents should never randomly modify your main working directory.
Every task gets an isolated Git worktree.
graphify/
│
├── main/
│
├── worktrees/
│ ├── issue-417/
│ ├── issue-421/
│ └── issue-430/
Each worktree can have its own agent, terminal, editor state, tests, and changes.
Agents can have memory.
But memory is not authority.
Git, the actual codebase, tests, CI, issues, discussions, documentation, and pull requests are always more authoritative than an agent's assumptions.
Osade is designed to give agents significant autonomy without giving them unrestricted control.
The human remains responsible for important decisions.
Agent → Understand
Agent → Implement
Agent → Test
Agent → Prepare
Human → Review
Human → Approve
Human → Ship
An agent shouldn't simply finish coding and immediately open a pull request.
Before contributing, Osade should understand how that repository expects contributions to happen.
Some projects may require:
- a discussion before implementation
- a specific issue format
- particular tests
- release notes
- screenshots
- specific commit conventions
- maintainer approval
Osade should account for these practices before an agent ships work.
Repositories contain a huge amount of knowledge that isn't necessarily written in one place.
Osade can learn from:
CONTRIBUTING.md- README and documentation
- Git history
- GitHub Issues
- GitHub Discussions
- Pull Requests
- code reviews
- CI failures
- repeated development patterns
The goal is to turn this information into useful, persistent knowledge.
There is no universal definition of "good contribution."
A workflow that is correct for one repository might be completely wrong for another.
Osade therefore builds repository-specific skills.
For example:
Graphify
Repository Skills
├── Discuss major API changes first
├── Prefer existing abstractions
├── Run integration tests
├── Include screenshots for UI changes
└── Keep PRs focused
While another repository may have completely different practices.
The agent doesn't need to memorize every repository manually.
Osade should learn the project's way of working.
Multiple agents may work on the same project at the same time.
They shouldn't operate as completely isolated individuals.
If Agent A discovers something important, Agent B should be able to benefit from it.
But Osade shouldn't blindly share entire conversations.
Instead, it should extract durable knowledge:
- facts
- decisions
- discoveries
- failed approaches
- procedures
- architectural knowledge
- repository practices
Agent A
│
▼
Discovery
│
▼
Osade Memory
│
▼
Agent B
Osade's knowledge is organized across different scopes:
Personal
↓
Organization
↓
Repository
↓
Task
↓
Agent
How you prefer to code and contribute.
Knowledge shared across related repositories.
How a particular project works.
What has happened while solving a specific issue.
The agent's current working context.
An agent shouldn't have to rediscover something another agent already learned.
Claude
│
│ discovers architecture constraint
▼
Shared Memory
│
▼
Codex
│
└── starts with that knowledge
This allows multiple agents to behave more like a team rather than independent sessions.
Open-source development rarely happens inside a single repository.
An organization may have:
Organization
│
├── core
├── sdk
├── documentation
├── examples
└── infrastructure
A single feature may require changes across several of them.
Osade treats the organization and its repositories as a connected development environment, rather than forcing the developer to manage each repository independently.
Different agents can work on different tasks and repositories at the same time.
Graphify
│
├── #417 → Claude → worktree-417
├── #421 → Codex → worktree-421
│
Graphify SDK
│
└── #81 → Claude → worktree-81
Graphify Docs
│
└── #132 → Gemini → worktree-132
All of this can exist inside one Osade environment.
You should always be able to see:
- what the agent is doing
- what files it changed
- what commands it ran
- what it discovered
- what it learned
- what tests passed or failed
- why it wants to perform an action
There should be no hidden agent state.
Osade follows a permission model rather than giving agents unlimited access.
| Action | Default |
|---|---|
| Read | Allow |
| Edit | Allow |
| Test | Allow |
| Commit | Configurable |
| Push | Ask |
| Create PR | Ask |
| Merge | Human only |
The exact policy can eventually be configured per repository, organization, or user.
An agent saying "I'm done" does not mean the task is done.
Osade should verify the work through:
- tests
- linting
- type checking
- repository-specific checks
- CI
- diff inspection
- repository contribution rules
The goal is to move from:
Agent says it works
to:
Osade verified it works
Every developer has their own workflow.
Over time, Osade can learn preferences such as:
Prefer small PRs
Run tests before pushing
Review diffs manually
Use worktrees for parallel tasks
Prefer existing abstractions
Never automatically merge
These preferences can be applied across repositories while still respecting each repository's own rules.
An agent workspace shouldn't disappear when you close the IDE.
Osade should preserve:
- worktrees
- agents
- terminal sessions
- editor state
- layouts
- task state
- memory
- agent progress
Close Osade.
Come back later.
Continue where you left off.
An agent's workspace is also your workspace.
You can:
Agent working
↓
Pause
↓
Inspect
↓
Modify code yourself
↓
Give control back to agent
There should never be a hidden layer between you and the code.
Osade is an environment, not a model.
Different agents should be interchangeable:
OSADE
│
┌────────┼────────┐
│ │ │
Claude Codex Gemini
│ │ │
└────────┼────────┘
│
Worktree
The architecture should allow different agent runtimes, including future local and open-source agents.
Osade is intended to build on Code-OSS, the open-source foundation behind VS Code.
The goal isn't to spend years rebuilding an editor.
The editor is the foundation.
Osade's focus is everything around it:
Code-OSS
+
Git Worktrees
+
Multi-Agent Runtime
+
Repository Intelligence
+
Shared Memory
+
Open Source Workflow
=
OSADE
Osade should remain reasonably close to upstream Code-OSS so that improvements to the underlying editor can continue flowing into the project.
The ultimate goal isn't autonomous coding.
It is trustworthy contribution.
Understand
↓
Isolate
↓
Execute
↓
Learn
↓
Verify
↓
Review
↓
Ship
↓
Remember
↺
Every contribution makes the environment smarter about the developer, the repository, and the organization.
We believe the next generation of open-source development won't be:
Human
↓
AI writes code
It will be:
Human
│
▼
OSADE
│
┌─────────────┼─────────────┐
▼ ▼ ▼
Agent Agent Agent
│ │ │
Worktree Worktree Worktree
│ │ │
└─────────────┼─────────────┘
▼
Shared Knowledge
│
▼
Tests / Review / CI
│
▼
PR
Humans decide. Agents execute. Osade coordinates and remembers.
🚧 Osade is under active development.
The project is currently focused on establishing the Code-OSS foundation and experimenting with the architecture for multi-agent, multi-worktree open-source development.
The long-term goal is to make Osade a complete development environment for contributors working with both humans and AI agents.
Osade is built on the Code-OSS project.
See the repository's license and attribution files for details.
