If you want to fix or enhance Oils, this is where to start!

Note: This wiki is also available in HTML at pages.oils.pub/wiki/Dev-Guide.html.

Table of Contents

• Contributing - setting up your dev environment
  • Making Pull Requests
  • Spec Tests are essential for design and implementation
• Oils Dev Cheat Sheet - a concise list of commands you may want to run
• Fourth Grant Goals and Guidelines
• Tips
  • Process Tracing Tips and Tools
  • Tips on Reducing Bugs to Small Test Cases
• AI Contribution Policy

Blog Posts by Contributors

• Eight Blog Posts by Contributors
• Four More Blog Posts from Contributors

To Sort Through

Some of these pages may be old:

• Oil Ninja Build
• Oil Native Quick Start
• OLD: Developing Oil With Nix
• Where Contributors Have Problems - initially written 2022
  • October 2025 Posting / October 2025 Reply
• Soil our CI
• Interactive Shell
  • Testing the Interactive Shell -- a bunch of manual test cases
  • Debugging Completion Scripts -- the useful --debug-file flag!

Collaborations

• Using Zephyr ASDL
• Implementing the Oil Expression Language
• Fish Oil Brainstorming
• Running ble.sh With Oil
• Running Package Builds with OSH
• Research Questions