Skip to content
Documentation separate from and across other Acorn repos
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.
vision removed date, corrected typos, clarified terms Feb 8, 2020 create Feb 10, 2020


Project Chat Forum Issue

CEPTR State of Affairs

WARNING: Current releases are prototype level functionality, they should not be used for production purposes and data will be lost between releases.

What is Acorn?

Acorn is a way of organizing intended Goals and Outcomes in tree-like structures. You can think of it as a virtual whiteboard for collaborative planning.

It could have many uses, and one that it has served is organizing the vision and work allocation of distributed teams of software developers. Other uses could be as a personal planning tool, for teams completely aside from software, or anything where linked/inter-related nodes in a structured form would be helpful.

Prefer a video introduction? SoA Lightning Talk

It is built as a Holochain application, meaning it runs on decentralized peer-to-peer computing and can be used without server infrastructure or a hosting service. The users of a particular Acorn instance are its hosting power.

What is Holochain?

Scalable distributed (peer-to-peer) apps with data integrity. Learn more at!

Why use Acorn?

Acorn creates an Agile process based on the Deming Plan/Do/Check/Act cycle, that is less bound to some of the traditional dependencies of Scrum and more applicable to projects and organizing beyond software development. The patterns Acorn enables and the resultant State-of-Affairs trees are scalable, handle complexity and uncertainty, and work with distributed groups.

Scrum, the roles of Scrum Master, Product Owner, and Devs, and the embodied tools of Kan-Ban and ticketing linked to git based source control, feel like a defacto standard in software development. For projects (software or otherwise) or organizations that do not find this model to be appropriate, or are finding it limiting, Acorn may provide a good alternative. If you or your group have not used Scrum but are considering it, we welcome you to try Acorn first.

Learn more about the vision and theory behind Acorn.

Who should use Acorn?

Acorn could work for individual organizing, and has been used with dozens of team members on globally distributed teams. It can be used by anybody who has a vision for the future and wants a process for reaching closer to that ever evolving vision.

What devices will Acorn work on? Can I use it?

There are standalone packages for macOS and Linux. It also could be run within the Holoscape hApp environment.

Windows users should look at alternatives with Virtual Machines or via Holo in a browser. We hope and expect it will be hosted by HoloOS nodes as those come online for Holochain apps.

To learn more, please explore our documentation or download and install a working prototype version on macOS or Linux. The app also has an intro guide when you start it for the first time!

WARNING: Current releases are prototype level functionality, they should not be used for production purposes and data will be lost between releases.

Is it Open Source?

Yes, all the code and documentation is available in these repositories:

At writing, in addition to the many self created or open files, there are a small number of image files that have been licensed (by Harris-Braun Enterprises, LLC from and for use in Acorn. We believe those would need to be replaced in a fork. The Acorn team intends to replace these licensed images with completely free alternatives as soon as feasible.

Please consult our ATTRIBUTION file for full details including other images, code, and prior work.

What license is Acorn under? Why?

This release is under the Cryptographic Autonomy License v1.0-Beta 4 (CAL), currently under review by the OSI. The license will be updated to the final version upon approval by the OSI.

CAL was created for the Holochain project to protect both source code and user data from restriction. It frees an end user from having their data held from them by a party that develops or hosts software licensed under CAL.

Who developed it?

Acorn was envisioned and prototyped (using a third party platform) by the Holochain core development team in 2018 to organize their own planning and execution process.

In August 2019 a team, eventually including people on four continents, undertook a design process and began building Acorn on Holochain. Contributors can be seen in our Holochain repo, our UI repo, for documentation, and releases.

Please consult our file for a list of contributors and their organizations.

The team has been hosted and supported by Harris-Braun Enterprises, LLC.

What are future plans for Acorn?

Take a look in Acorn! If you install a release of Acorn and connect to our tree, you can see and contribute to the planning of future development.

You can also join the open discussion on the Holochain forums, or the development chat channel. (let us know if you need a invitation)

This is an open source project, please contribute!

Having trouble? Report an issue!

Please submit an issue with your experience and include as much detail as possible including log(s), screenshot(s), and reproducing steps. You can also make feature suggestions as issues, or come discuss them at the forum or chat channel.


License: CAL v1.0 Beta 4

Copyright (C) 2020, Harris-Braun Enterprises, LLC

You can’t perform that action at this time.