owlgo 0.1.7

A lightweight CLI to assist in solving CP problems
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

# owlgo
The Algo Owls CLI is a lightweight and blazingly fast (**sorry**) tool to provide LLM integration into your programming practice.

![Made with VHS](./demos/owlgobanner.gif)

The above example was generated with VHS ([view source](https://github.com/charmbracelet/vhs)).

## Tutorial

To get started, [install owlgo](#installation). Fresh installs won't typically come with templates files, so you'll need to first create a program. If you have a program that you would like to use as a template, you can stash the program.

```sh
owlgo stash -T hello.rs
```

If you do have a template file stashed away, you can initialized a new program from that stashed template.

![Made with VHS](./demos/init_demo.gif)

Once you've finished implementing your solution, you can run the solution using owlgo. This makes it much easier to ensure that you're using the same build/run arguments that competitive programming (CP) contests use. It also has the upside of making it easier to use new languages. **owlgo supports nearly two dozen languages including those officially used by ICPC and USACO.**

![Made with VHS](./demos/run_demo.gif)

If your program seems to be working, it's time to start your quest to solve the problem. Many CP problems have test cases published online. owlgo can fetch these test cases for you.

![Made with VHS](./demos/fetch_demo.gif)

If you don't want to fetch the test cases, owlgo will always fetch them for you once you attempt a quest. A quest in this case is an attempt to pass all provided test cases for a CP problem. owlgo makes it easy to check your solution against the test cases and provides feedback on each test case.

![Made with VHS](./demos/quest_demo.gif)

If you're having trouble solving a problem, understanding the problem description, or would just like to explore the problem further, owlgo provides LLM integration right from your terminal.

![Made with VHS](./demos/review_demo.gif)

> [!NOTE]
> Note that the above example has been edited to remove the time that claude took to think. Responses typically vary between 10-30s.

If you'd like, you can go back and view your chat history or any of your other stashed files at any time.

![Made with VHS](./demos/list_demo.gif)

To ensure that you never lose your history or any of the hard work that you've put into improving your programming skills, owlgo also provides git integration.

![Made with VHS](./demos/git_demo.gif)

## Install

Use the cargo package manager:

```sh
cargo install owlgo
```

Run help to ensure that it installed correctly and begin exploring what owlgo can do.

```sh
owlgo -h
```