gort

README

Gort

This project is a work in progress under active heavy development. It is not production (or even alpha) ready! Follow for updates!

Gort is a chatbot framework designed from the ground up for chatops.

Gort brings the power of the command line to the place you collaborate with your team all the time -- your chat window. Its open-ended command bundle support allows developers to implement functionality in the language of their choice, while powerful access control means you can collaborate around even the most sensitive tasks with confidence. A focus on extensibility and adaptability means that you can respond quickly to the unexpected, without your team losing visibility.

Rationale

Gort was initially conceived of as a Go re-implementation of Operable's Cog Slack Bot, and while it remains heavily inspired by Cog, Gort has largely gone its own way.

Cog was originally designed as a distributed computation engine that was later re-branded as a chatops tool, and much of this original intent was reflected in its design, implementation, and feature set. As a result, many of Cog’s features, however innovative, went largely unused, and the codebase had become difficult to extend and maintain. These difficulties were compounded by its implementation language -- Elixir -- which has relatively few proficient developers.

The solution, which was discussed for many months on the Cog Slack workspace, was to rewrite Cog from scratch in a more accessible language, such as Go, removing some of less-used functionality and reducing complexity in the process.

This gives us the opportunity to consider and possibly redefine what Cog was meant to be. To choose the features that make sense, and to discard those that don't. In this way, Gort can be described more as a “spiritual successor” to Cog than a faithful re-implementation: many things will change, others will cease to exist entirely.

Features

The primary goal of this project is to re-implement the core features of Cog that made it stand out among other chatops tools. Specifically, to:

• define arbitrary command functionality in any programming language,
• package those commands into bundles that can be installed in Gort,
• allow users to trigger commands through Slack or another chat provider and be presented with the output,
• execute triggered commands anywhere a relay is installed using a tag-based targeting system,
• regulate the use of commands with a built-in authentication/authorization system,
• and record activity in an audit log.

This includes all of the high-level features listed in the Cog documentation.

Gort design

A WIP design doc, including rough milestones (but not dates) can be seen here. Feel free to add questions or comments.

Status of this project

Active heavy development. The date that various milestones have been achieved are listed below. The number and focus of present and future milestones are subject to change.

• Project created: 27 December 2018
• Milestone 1: 7 January 2019
• Milestone 2: 21 January 2019
• Milestone 3: 24 January 2019
• Milestone 4: 17 March 2019
• Milestone 5: TBD
• Milestone 6: TBD
• Milestone 7: TBD
• Milestone 8: TBD
• Release candidate 1: TBD
• Release!: TBD

How to run

With Go installed, you can run (for testing) with: go run . start.

Note that you'll need a proper API key in the config first!

Gortctl

The gortctl administration CLI can be found in its own repository.