rea
Reverse engineer anything with agents, from app behavior down to native binaries.
- 471k
- TypeScript
- MIT
- 2 h ago
An easy to use CLI for the OpenProject APIv3
Repo opf/openproject-cli, read from GitHub 1 min ago. opf has not joined Take My Repo.
opf/openproject-cli is a public repo on GitHub by opf. An easy to use CLI for the OpenProject APIv3. It declares the GPL-3.0 license on GitHub. It is written mainly in Go, has 44 stars and last changed on 2026-08-18. Nobody has reviewed it on Take My Repo yet, which says nothing about its quality. Read from GitHub on 2026-11-20.
In the maintainer's words. Shown from GitHub; Take My Repo does not keep a copy.
Warning
Please read before installing or upgrading to v0.6.
op work-package list). Scripts and workflows built on v0.5.x will need updating.If you value stability over new features, we recommend staying on v0.5.5 for now. It is equally unsupported, but has a smaller surface area and a longer track record.
OpenProject CLI is a tool for operating your OpenProject instances from the command line. Therefore, it provides a subset of use cases for OpenProject.
The OpenProject CLI is meant to be operated in a self-explanatory and easy-to-use way. It provides meaningful commands without abbreviations, that can be executed in a human-readable manner. For more experienced users, many commands provide aliases for fewer keystrokes.
There are many ways to install the OpenProject CLI:
Executables are provided for Linux, macOS and Windows (currently Linux x64 only).
You can find the executables in the Releases section of this repository. The latest release is available under https://github.com/opf/openproject-cli/releases/latest.
Download the zip archive for your operating system and desired version of the OpenProject CLI:
curl -O https://github.com/opf/openproject-cli/releases/download/0.2.0/openproject-cli_linux_x64_X.Y.Z.zip
Extract the executable from the zip archive and move the executable to a location that is within your PATH:
unzip openproject-cli_linux_x64_X.Y.Z.zip sudo mv op /usr/local/bin
Check if the executable is working:
op --version
OpenProject CLI: X.Y.Z
commit: 8dc3232
built: Thu Jun 29 20:41:41 UTC 2023
built with: go1.20.5MacOS will place the executable in quarantine by default. If your Mac displays an alert when you run the executable, you can dequarantine the
opexecutable via the following command:
xattr -d com.apple.quarantine /usr/local/bin/op
If you already have the Go toolchain installed on your system, you can install the OpenProject CLI with the go install
command:
go install github.com/opf/openproject-cli@latest
This will install the most current commit development version for now. Keep in mind that the resulting command is also
not op but openproject-cli. You can though rename the binary installed in your GOPATH or GOBIN directory.
The OpenProject CLI supports auto-completion out of the box. You can generate the completion script by running:
op completion [shell]
Replace [shell] with either bash, fish, powershell, zsh to generate the shell specific completion script.
You need to put the completion in a place where your shellcan find it. For ZSH this could look like:
op completion zsh > ~/.oh-my-zsh/completions/_op rm ~/.zcompdump*
Open a new shell and completion should work by using the TAB key as usual.
The OpenProject CLI commands are structured in a common, human-readable pattern. Every command is built
as op NOUN VERB [additional information]. You will see plenty of examples within this section.
Earlier releases (up to 0.5.5) used verb-first commands. These have been replaced without aliases; scripts need to migrate:
| Old (verb-first) | New (noun-first) |
|---|---|
op list workpackages |
op work-package list |
op create workpackage |
op work-package create |
op update workpackage |
op work-package update |
op inspect workpackage |
op work-package inspect |
op search workpackages |
op work-package search |
op list projects |
op project list |
op inspect project 42 |
op project inspect 42 |
op list notifications |
op notification list |
op list activities 42 |
op activity list --work-package 42 |
op list status |
op status list |
op list types |
op type list |
op list timeentries |
op time-entry list |
op search user X |
op user search X |
Discoverability is key. As we won't document every single command within this README, it is important for the CLI tool,
to provide helpful information at any time and any level of the command structure. To achieve that, the OpenProject CLI
has a help page on every command. Adding the --help/-h flag to any chain of commands will tell the user of all
possibilities he can use from here.
# General help op -h # Help about work package commands op work-package -h # Help about how can I narrow down my list of work packages op work-package list -h
The second basement is the autocompletion. To set it up correctly, follow the steps explained in the Completion
section above.
Once it is working, you can use it to discover possible commands and flags while typing.
# Chaining commands: hitting completion key after op work-package # returns create -- Create work package in project inspect -- Inspect a work package list -- Lists work packages search -- Searches for work packages update -- Update a work package # Discover flags: hitting completion key after op work-package update 42 - # returns --action -a -- Executes a custom action on a work package --assignee -- Assign a user to the work package --attach -- Attach a file to the work package --help -h -- help for work-package --subject -- Change the subject of the work package --type -t -- Change the work package type
Run op login to authenticate. You will be prompted for the host URL, an API
token, and a profile name (defaults to default):
op login # Profile name? [default] # OpenProject host URL: https://community.openproject.org # OpenProject API Token: ...
Use named profiles to work with more than one OpenProject instance:
# Create a profile named "work" op login --profile work # Create a profile named "staging" op login --profile staging
All commands accept a --profile flag to select which instance to use:
op work-package list --profile work op project list --profile staging
The OP_CLI_PROFILE environment variable is an alternative to --profile,
useful in scripts or shell sessions where you always want the same instance:
export OP_CLI_PROFILE=work op work-package list # uses the "work" profile
When both are set, --profile takes precedence. The explicit credential
variables OP_CLI_HOST and OP_CLI_TOKEN override everything.
op whoami shows all configured profiles together with their server URL and
authenticated user:
op whoami # Profile: default # Server: https://community.openproject.org # User: #42 Jane Doe # # Profile: work # Server: https://work.example.com # User: #7 John Smith
Pass --profile to inspect a single profile:
op whoami --profile work
op logout removes a profile (defaults to default):
op logout # removes the "default" profile op logout --profile work
Profile names may only contain letters, digits, - and _; hyphens must not
be consecutive, leading, or trailing. When prompted interactively the CLI
suggests a sanitized version of any invalid input.
There are a couple of use cases, you might want to execute from the command line. In this section we provide a handful of examples, that might be useful for a great number of people.
# Creating a work package in a project only by subject. # Work package is created with many default values (as for type and status), # very similar to how a work package is created inline in a work package table. # --project accepts either a numeric ID or the project identifier from the URL. op work-package create --project 11 'Document new CLI tool' op work-package create --project my-project 'Document new CLI tool' # Same command with shorthands and directly open it in a browser to continue working on it. op work-package create -p11 'Document new CLI tool' -o
# Get a list of unread notifications and filter them by reason op notification list --reason mentioned # Get a list of all work packages assigned to me op work-package list --assignee me # Get a list of direct children of a work package # --parent-id accepts either a numeric ID or a project-based identifier (e.g. PROJ-123) op work-package list --parent-id 42 op work-package list --parent-id PROJ-123
# Executing a custom action on a work package # The ID argument accepts either a numeric ID or a project-based identifier (e.g. PROJ-123) op work-package update 42 --action Claim op work-package update PROJ-123 --action Claim # Batch updating some properties of a work package op work-package update 42 --subject 'The new subject' --type Implementation # Local inputs are validated before the first change is sent. Each API action # remains a separate request, so an earlier change may remain if a later # request fails. # Uploading an attachment to a work package op work-package update 42 --attach ./Downloads/Report.pdf
# Search work packages by subject, type, status, project name, or identifier. # Multiple words are ANDed: all terms must match. Returns up to 100 results. op work-package search cascade op work-package search fix login # Limit search to a specific project (numeric ID or identifier) op work-package search cascade --project my-project op work-package search cascade -p 11
# Inspecting a work package with more details, # then in the work package list command # Accepts either a numeric ID or a project-based identifier (e.g. PROJ-123) op work-package inspect 42 op work-package inspect PROJ-123
The repository ships a .claude/op.md reference file that teaches Claude Code how to use op. Once set up, the agent will use op proactively whenever you discuss work packages, projects, or anything OpenProject-related.
~/.claude/CLAUDE.md is Claude Code's global instruction file — create it if it doesn't exist yet.
Symlink the file into your Claude configuration directory from the repo root:
ln -s $(pwd)/.claude/op.md ~/.claude/op.md
Then add a line to ~/.claude/CLAUDE.md:
Use `op.md` as a reference for all `op` CLI commands (work packages, projects, time entries, search, profiles…). Read it whenever the user asks about OpenProject or wants to use `op`.
The symlink keeps the file in sync automatically as you pull new versions.
Add a line to the project's CLAUDE.md at the repo root:
Use `.claude/op.md` as a reference for all `op` CLI commands (work packages, projects, time entries, search, profiles…). Read it whenever the user asks about OpenProject or wants to use `op`.
No copy or symlink needed — the path is relative to the project root.
Releases are triggered by pushing a git tag. The tag name becomes the version string embedded in the binaries.
git tag vX.Y.Z git push origin vX.Y.Z
This triggers the Release workflow, which builds binaries for all platforms and publishes a GitHub release with zip archives attached.
Once the workflow completes, go to the GitHub releases page and manually edit the release to add the release notes.
opf/openproject-cli is a public repo on GitHub by opf. An easy to use CLI for the OpenProject APIv3.
It declares the GPL-3.0 license on GitHub.
Its maker has not tagged a system, so it is unknown here. Its README says what it needs.
Open "Take it" on its page: Take My Repo writes an install plan for your machine and hands it to your AI agent (Claude Code, Codex or Cursor), which asks you before each step. Take My Repo has not tested it on any machine.
Its last change on GitHub was on 2026-08-18. Take My Repo does not judge from that whether it is maintained.
Nobody has reviewed it on Take My Repo yet, which says nothing about its quality.
Reverse engineer anything with agents, from app behavior down to native binaries.

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
A feature-rich command-line audio/video downloader
OpenProject is the leading open source project management software for product, project and portfolio management. A powerful Jira alternative with agile planning, issue tracking, roadmaps, Gantt charts, time tracking, collaboration features, and more. Available on premises or in the cloud. ⭐ Star us on GitHub
Recipes to deploy OpenProject with Docker, Docker Compose, Kubernetes, etc.
OpenProject Community Edition Build repository for versions 6.x to 8.3.2. Please see https://github.com/opf/openproject for current builds!


Exemplary OpenProject plugin demonstrating different ways to extend OpenProject.
This page is also available as structured data, with the same sources and dates.
/api/v1/resources/gh/opf/openproject-cliTake My Repo has not tested this on your machine. Requirements come from the project's own documentation.