1Password CLI 1

1.12.7  (build #1120702) – released 2023-11-21

This release contains dependency updates.

1.12.6  (build #1120602) – released 2023-10-19

This release contains a security update.

Security

• Unprintable characters are now filtered out from the output of the V1 CLI, when used interactively. {1705}

1.12.5  (build #1120501) – released 2022-05-20

This release contains a bugfix and security updates.

Fixed

• Ensure user properties are correctly populated by getting user object from user API. {2432}

Security

• Better sanitize injection vectors in the CLI's environment. {1673}
• Improved validation of server parameters in SRP process. Credits to Cure53. {2442}

1.12.4  (build #1120401) – released 2022-01-14

This release contains a bugfix to prevent the op get totp command from crashing when an item has an empty totp field.

Fixed

• The CLI doesn't crash when an item has 2 OTP fields and one of them is empty. {1882}

1.12.3  (build #1120301) – released 2021-10-27

This release contains a bugfix described below.

Fixed

• Retrieving items when using --format csv no longer returns an error when date and monthYear type fields are specified. {1672}

1.12.2  (build #1120201) – released 2021-10-05

This release makes various improvements to our help commands and supporting documentation.

Improvements

• Updated docs to deprecate the `encode` command. {1629}

Fixed

• Corrected a mistake in the `create vault` command's `--description` flag help text. {1628}

1.12.1  (build #1120101) – released 2021-10-04

This release introduces the template flag to specify item templates as file paths when creating items.

New

• You can now create items using a template file loaded from disk. {1620}

Fixed

• "op update" will work again going forward on MacOS. {1572}

1.11.4  (build #1110401) – released 2021-09-01

This release fixes a handful of behind-the-scenes bugs and introduces a new flag to set a custom icon when creating or editing vaults.

New

• The `create vault` and `edit vault` commands can specify an icon with the --icon flag. {1514}

Fixed

• Fixed panic when creating Events API or Connect instance. {1537}

1.11.3  (build #1110301) – released 2021-08-25

This release introduces some quality of life features, bugfixes, and security patches for the 1Password CLI.

New

• Added support for listing item categories and fetching templates for them through the Connect API. {1384}

Improvements

• Users can now edit the vault description using "op edit vault --description". {1225}

Fixed

• "op edit document" no longer overwrites existing sections and notes when unspecified. {1488}
• Fix proxy support for the signin command. {1500}

Security

• Improved input validation for email addresses on signin. Credits to Cure53. {1466}

1.11.2  (build #1110201) – released 2021-07-23

This release fixes a case where Password items created from the web client were not able to be deleted from the 1Password CLI. In addition, we improved the CLI's security by restricting sign in addresses to 1Password domains.

Fixed

• Password items created on the web client no longer fails item validation in the CLI. {1451}

Security

• Allowed sign in domains are restricted to public 1Password servers. Credits to Cure53. {1465}

1.11.1  (build #1110101) – released 2021-07-22

This release brings native support for the Apple M1 chip and Linux computers with a 64-bit ARM chips.

New

• Added a new ARM64 build of the tool, for Apple M1 Macs and Linux computers with a 64-bit ARM chip. {902}

Fixed

• Clarify error message when signing in with the wrong sign-in address. {1448}
• Password entropy values are now included in the output of items with generated passwords. {1485}
• Added a check for nil group keysets when adding a user to a group the acting user is not a part of. {1471}

1.11.0  (build #1110001) – released 2021-07-15

This release introduces support for 1Password Events Reporting. Learn more about it at https://support.1password.com/events-reporting/.

To set up and issue tokens for 1Password Events Reporting, use op create integration events-api

New

• Set up 1Password Events Reporting integrations. {b5#12903}

Fixed

• Manage vault access will be retained while adding group access. {1453}

1.10.3  (build #1100301) – released 2021-06-17

This release contains fixes and improvements to Secrets Automation management.

Fixed

• Delegate Secrets Automation management to a group when the account does not have an existing environment configured. {1307}

1.10.2  (build #1100201) – released 2021-06-08

This release contains a fix that impacted some user's ability to signin.

Fixed

• Corrected an issue impacting some users on sign-in. {1423}

1.10.1  (build #1100101) – released 2021-06-07

This release contains changes to allow op delete vault to continue working without interruption.

Fixed

• Updated the delete vault command to use the latest server API. {1417}

1.10.0  (build #1100001) – released 2021-05-25

This release introduces the Archive, replacing the Trash. It's useful for items you need to store long-term, but don't want to appear in the browser as filling suggestions. Learn more about it at https://blog.1password.com/introducing-archive/. Try it out with op delete item --archive "Defunct Login"

New

• An item or document can now be deleted directly or optionally archived. {11613}

Fixed

• Tokens can now be created for Connect instances you only have the "issue token" permission for. {1361}

1.9.2  (build #1090201) – released 2021-05-06

This release fixes an issue with the "list events" command returning audit log events with empty "actorUuid" fields.

New

• Using "op signin --list" will show all of the configured accounts. {1339}

Fixed

• Actor UUID will be correctly populated in the "list events" command. {1363}

1.9.1  (build #1090102) – released 2021-04-23

This release fixes an issue with the "update" command that would attempt to update the command-line tool even when on the latest version. Also in this release, getting a custom template will now show the correct field and section names.

Fixed

• The help text of "signin" now shows PowerShell commands when run in PowerShell. {1254}
• Getting a custom template now correctly outputs the template's section and field titles. {1192}
• The "update" command will no longer attempt to update while on the latest version. {1330}

1.9.0  (build #1090002) – released 2021-04-12

This release introduces support for 1Password Secrets Automation. Learn more about it at https://1password.com/secrets/.

You can set up and get credentials for 1Password Connect servers, and issue tokens for them. Use "op create connect server" and "op create connect token". Grant and revoke a server's access to vaults with "op add connect" and "op remove connect". With 1Password Business, you can manage group access to Secrets Automation with "op manage connect add" and "op manage connect remove".

This release also includes the ability to change character encoding processing from UTF-8 to Shift-JIS or GBK with the "--encoding" option. You can also now confirm guest users and macOS 11 "Big Sur" users can now verify the package signature in the installer.

New

• Set up and manage 1Password Secrets Automation with 1Password Connect servers and tokens. {1278}
• Use the "--deauthorize-devices" option with "op suspend" to deauthorize a user's devices during suspension. {b5#7558}
• You can now confirm Guest users.
• Use a character encoding other than UTF-8 with the "--encoding" option. Supported encodings: "shift-jis" and "gbk". {762}

Improvements

• Added "Password" and "Document" to the list of categories in "op get template --help" and "op list items --help".

Fixed

• Retrieving items with additional attributes no longer causes an error. {1017}
• Changed Darwin package signing to work in the installer on macOS 11 "Big Sur". {1105}
• An item's password strength is now computed and uploaded when creating or editing a password field instead of defaulting to 1. {1099}
• Password generation adheres to the password recipe as strict requirements. {1219}
• "op forget" prints a newline after its output. {1291}

1.8.0  (build #1080001) – released 2020-10-22

Cache information, speed up commands. When you use the "--cache" option on Linux, UNIX, and macOS systems the "op" daemon caches information to get it to you faster.

The tool now follows the XDG standard more closely and stores your configuration files in "${XDG_CONFIG_HOME}/op/" (usually "~/.config/op/").

Your configuration in "~/.op/" will still work or you can move it to the new location. If you want to use a custom location, use the "--config" option with each command.

New

• Use the "--cache" flag with commands to use client-side caching for keysets, vaults and item information.
• Use a custom configuration location with the "--config" option.

1.7.0  (build #1070001) – released 2020-09-15

Embrace change with the new "edit document" command. Use it to replace the file stored in a Document item with an updated or entirely new file.

There's more scripting love in this release too: "op delete item" and "op delete document" now accept object specifiers on standard input.

New

• "op delete item" and "op delete document" now accept object specifiers on standard input.
• Replace the file stored in a Document item using "op edit document".

Fixed

• You can now add users to a vault even if they already have access to it through a group membership.
• Corrected possible failure to detect whether the tool is being used on a terminal or not.
• Updated macOS build to Go 1.14.7 to solve issues with pre-AVX CPUs.

1.6.0  (build #1060001) – released 2020-09-01

Good news for scripters: You can now provide a session token to the 'signin' command. In scripts, this can provide a way to test whether a session is still active or to reuse a session. If it's active, the tool returns the same token and you don't have to sign in again.

You can now get a user's role in a group when you use 'op list users' with the '--group' option.

New

• 'op signin' can reuse an existing session.

Improvements

• Increased performance of 'get item' when fetching an item by UUID without a vault query.
• The output of 'op list users --group ...' includes the user's membership role.
• Reworked some help text examples to cover more use cases.

1.5.0  (build #1050001) – released 2020-08-18

We've got a housekeeping release of the 1Password command-line tool for you this time. The tool now starts a daemon to clean up expired session files automatically on supported systems. Updating is easier, too: the "update" command can now download updates for you.

In addition, to help with your own housekeeping, you can now list the vaults or groups a user has access to. Use the new "--user" option for "list vaults" and "list groups".

New

• A daemon is automatically started to periodically remove expired session files. The daemon stops when there are no more session files. (Not available on Windows.)
• The "list groups" and "list vaults" commands now support a "--user" option to list the vaults and groups a user has access to.

Improvements

• The "update" command can now download updates for you. Use the "--directory" option to set the download location manually.
• Updated to Go 1.14.7.

1.4.0  (build #1040001) – released 2020-07-30

This release brings a time-saving new feature for owners and administrators: you no longer have to be a group member before you can add people to a group.

New

• Rename vaults with the new "edit vault" command.

Improvements

• Owners and administrators can add people to a group without being a group member themselves.

1.3.0  (build #1030001) – released 2020-07-17

This release adds support for reading object specifiers from standard input to "get item", "get totp", "get vault", "get user", and "get group". This makes it possible to process multiple objects more efficiently.

To make the command-line tool easier to use in containerized environments, you can use the "OP_CONFIG_DIR" environment variable to specify the directory for your configuration files. ("~/.op/" by default).

New

• Customize the location for the configuration directory with the "OP_CONFIG_DIR" environment variable.
• "get item", "get totp", "get vault", "get user", and "get group" can process JSON objects and object specifiers on standard input.

Improvements

• Made wording for "op update" more consistent.
• Updated in-app help: clarified creating items with a template, and simplified instructions for generating completion information.

1.2.1  (build #1020102) – released 2020-07-10

This release contains an internal API change to maintain compatibility with 1Password.com.

Fixed

• Updated internal group management API for 1Password.com.

1.2.0  (build #1020001) – released 2020-07-02

This release adds three features to make it easier to work with the 1Password command-line tool. You can now generate shell completion information, filter output from "list items" by tag and category, and use standard input (stdin) when you create a Document item.

New

• The "completion" command generates a script to add shell completion support for bash and zsh. See "op help completion" for more information.

Improvements

• "op create document" can now add a file with information passed on standard input (stdin). Use a hyphen (-) instead of specifying a file path.
• You can filter output from "op list items" with the new "--tags" and "--categories" options.

1.1.1  (build #1010101) – released 2020-06-22

This release only contains a fix that prevented people to signin with certain domains.

Fixed

• "op signin" works again for all 1Password domains.

1.1.0  (build #1010001) – released 2020-06-12

You can now specify a device UUID in an environment variable. This should make it easier to use the command-line tool in an automated environment with containers.

New

• The device UUID can be set in an environment variable (OP_DEVICE).
• Device UUIDs are now stored in the config file instead of a separate file. The first time you use this version, your existing device UUID is moved to the config file and the device file is deleted.

Improvements

• You can now change the role for a group member from "manager" to "member".
• Attempting to add a user to a group that they're already in will no longer return an error.
• Tweaked how request IDs are generated to improve running multiple processes of the tool at the same time.
• The tool now properly generates the subtitle (ainfo field) for all item types.
• "op signin" will always use https:// for the sign-in address.
• The tool makes it clear when waiting for the user to enter their Secret Key.
• Improved the output and error messages of various commands.

Fixed

• "op edit item" can now always change username and password fields for Login items, even if those fields don't exist in an item.
• Custom icons for items are now preserved after editing an item with the command-line tool.
• The password strength is now correctly computed for generated passwords.
• Fixed various crashes.

1.0.0  (build #1000001) – released 2020-05-20

We are excited to release version 1.0 of the 1Password command-line tool!
In this release, we add the ability to choose which fields are returned by "get item". When a single field is requested, its data is returned as a simple string. For multiple fields, data is returned in a JSON object or in CSV format.

New

• You can specify which fields are returned by "get item" with the "--fields" and "--format" flags.
• You can customize the "--generate-password" option for "create/edit item". Use a password recipe to specify the length and characters included.

Improvements

• Using "reactivate" on an active user no longer returns an error.
• Various error messages have been clarified.

Fixed

• Fixed a panic caused by using "--shorthand" when signing in after the first time.
• Fixed problem where session files could become corrupted when running multiple "op" commands concurrently.

0.10.0  (build #100002) – released 2020-04-20

This release introduces new features for working with items. The new "edit item" command uses a new value-assignment syntax, which can also be used with "create item".
Documentation and help text have been improved. There’s a new command-line tool reference page, which shows the descriptions and help text for all commands and options.

New

• "op edit item" allows you to update the existing fields of an item via a simple assignment syntax. See "op edit item --help" for more information.
• "op create item" was updated to accept the same assignment arguments as "op edit item", greatly simplifying the process of creating new items. You don't have to use JSON templates anymore (but you can).
• The "--generate-password" flag was added to "op create item" to set a random password for a new Login or Password item. See "op create item --help" for more information.
• Creating a new vault now assigns a random icon to the vault from our collection of default vault icons.

Improvements

• Help text and error messages have been updated to be clearer and more useful.

Fixed

• The "op help" command correctly outputs the help for a command

0.9.4  (build #90401) – released 2020-03-26

This release contains a security improvement and a couple of fixes.

Improvements

• Better validation of email address passed to "create user".

Fixed

• PowerShell accepts password at the password prompt again.
• "eval $(op sigin ...)" doesn't error the first time someone logs into an recovered account.

Security

• Increased validation of config and session directories and files before reading from or writing to them. Credit: Cure53.

0.9.3  (build #90301) – released 2020-03-12

This release contains a security improvement and several smaller improvements to user input validation and corresponding error messages.

New

• You can now link directly to items within your 1Password vaults! Share these links with team and family members to point them right to items in shared vaults. Use "get item --share-link" to generate a link. "get item" was also updated to understand share links as input.

Improvements

• "edit user" returns a better error message when an empty user is passed.
• "create item" retries once to create the item if a conflict was encountered.
• "signin" validates the URL before asking for Secret Key or Master Password.
• "get item" should perform better when searching for an item in all vaults.
• "create item" returns a useful error when empty title, tags, url or vault are passed.
• Passing a non-existing account to "--account" returns a useful error.
• Better user experience when signing into a recovered account for the first time.

Fixed

• Items of certain types can now be created even if certain fields are not filled.
• In rare situations listing or searching for items could result in an error if a vault was deleted while running the command.
• The values for the "--account" and "--session" flags can now be specified without a "=".

Security

• Increased validation of config and session directories before reading from or writing to them. Credit: Cure53.

0.9.2  (build #90201) – released 2020-01-31

This release addresses the issue using "op confirm user --all", and includes some new conveniences for working with vaults and documents.

New

• Added a "delete document" command.
• Added a "--description" flag to the "create vault" command.

Improvements

• The "list documents" command will now ignore trashed documents by default, and gains an "--include-trash" flag to match the "list items" command.

Fixed

• Using the "--all" flag with "op confirm user" will no longer result in an error.

0.9.1  (build #90101) – released 2020-01-27

Hot on the heels of version 0.9, 0.9.1 restores the update command and signin command's --shorthand flag.

Fixed

• Restored the update command that was removed in 0.9.
• Restored the --shorthand flag that was removed in 0.9.

0.9.0  (build #90001) – released 2020-01-27

This release replaces the command-line tool's underlying library to provide better handling of inputs and outputs, as well as more informative and up-to-date help text and errors. It also includes some new functionality, check out all the changes below!

New

• "add" and "remove" commands have been removed in favor of the following commands:
• "add user" allows adding users to groups or vaults.
• "add group" allows adding groups to vaults.
• "remove user" allows removing users from groups or vaults.
• "remove group" allows removing groups from vaults.
• The "help" command can now be used in addition to the "--help" flag.
• The new "--output" flag on the "get document" command allows writing directly to a file.

Improvements

• Flag values can now be provided without "=". "--vault someVault" and "--vault=someVault" are both valid.
• "create user" now accepts "<name> instead of "<firstname>" and "<lastname>".
• "edit user" now accepts "--name" instead of "--firstname" and "--lastname".
• Various help and error messages have been improved.
• Updated to Go 1.13.5.

Fixed

• "get totp" ignores items in the Trash.
• "forget account" will return an error if an empty account name is passed.
• "forget account" will not fatal if a non-existing account is passed.
• Creating groups with empty of white-space only names is disallowed.
• Creating vaults with empty of white-space only names is disallowed.
• Creating empty or white-space only item tags is disallowed.

0.8.0  (build #80002) – released 2019-11-07

This release adds more commands and options to manage users. In particular, "create user" allows you to invite a user, "confirm --all" allows you to confirm all pending accepted invitations. This is also the first release that notarizes Mac OS binaries for Catalina.

New

• "create user" allows admins to invite new users.
• "confirm --all" allows admins to confirm all pending accepted invitations.
• "forget " and "signout --forget" will remove locally stored information of the account from the device.

Improvements

• Mac OS builds are now notarized.

0.7.1  (build #70101) – released 2019-10-29

This is a small bug fix release which fixes issues with Password creation and deleting user accounts.

Fixed

• The tool will no longer exit with an error when creating a new Password item.
• The tool will no longer exit with an error when deleting an invited but not yet confirmed user.

0.7.0  (build #70001) – released 2019-10-23

This release introduces the ability to manage and query all of the different types of access in your account. You can now query users by vaults and groups ("op list users --vault" and "op list users --group"). You can now list vaults in terms of what groups can access them and vice versa! ("op list vaults --group" and "op list groups --vault"). See below for all of the access-related improvements. In addition to all of that, we have made some changes to help op work better in scripts, and added the ability to confirm invited user's accounts!

New

• When using "op create vault", you can now pass the "--allow-admins-to-manage" flag to configure admin access.
• Added the ability to confirm invited users using the "op confirm" command.
• Added the --vault flag to "op list users" to allow listing all users who can directly access a vault.
• Added the --group flag to "op list users" to allow listing all users who belong to a group.
• Added the --group flag to "op list vaults" to list all vaults that a group has access to.
• Added the --vault flag to "op list groups" to list all groups that have access to a vault.
• [IMPROVED] The [eventID] and [direction] arguments in the "op list events" command are now optional flags.

Improvements

• op will now handle input passed through stdin properly in most cases.
• Updated to Go 1.12.10.

Fixed

• Improved help text for some commands.

0.6.2  (build #60201) – released 2019-09-18

This version of the command-line tool fixes a crash when using a 32-bit or ARM system, and adds some small tweaks to make using the tool a bit easier!

New

• A Docker version is now available on Docker hub! Run "docker pull 1password/op:v0.6.2".

Improvements

• Item commands will be even faster, again! Those of you with a large number of vaults will see an especially large bump in performance.
• A better error will be shown when the create item command encounters unexpected input.
• Using the create group command will no longer result in a massive amount of JSON.
• The suspend command will now notify you if the user is already suspended.
• The tool will now handle cases of un-writable configuration directories more gracefully.

Fixed

• The tool will no longer crash when used on 386 or ARM architecture machines.
• Added some missing flags to command help texts.
• The tool will no longer exit with an error code when no items exist in a list.
• The create item command will now show the correct createdAt and updatedAt timestamps in its output.

0.6.1  (build #60101) – released 2019-08-26

After the 0.6 release last week, we found an issue that would prevent you from signing in to more than one account from the same team or family. This has been fixed!

Fixed

• Signing in to more than one account from the same team or family now works again as expected.

0.6  (build #60001) – released 2019-08-23

This update brings some improvements to make working with the command-line tool faster and easier! When two-factor authentication is enabled on your account, you will no longer need to enter your 6-digit code on each sign-in. We have made some some speed improvements when working with items, and you will now be warned when attempting to create an item with invalid JSON structure. We hope you'll leave your feedback in our discussion forums, and hope to continue making the command-line tool as useful as possible!

Improvements

• When 2FA codes are enabled on your account, you will now only need to enter it on the first sign-in, not every time.
• When creating an item, op will now cause a warning or error when the item has the wrong JSON structure.
• Searching for an item without its UUID and listing items will now run more quickly.

Fixed

• Adding a user to a vault will now give the user Read/Write/Export permissions rather than full permissions.

0.5.7  (build #57001) – released 2019-06-25

This update includes more intelligent error handling related to sign-in.

Improvements

• op will now present more intelligent messages when there is a failed sign-in attempt.

0.5.6  (build #56002) – released 2019-05-07

Today's update ensures compatibility with upcoming changes related to MFA.

Improvements

• Future-proofed the command-line tool's compatibility with 1Password MFA.

0.5.5  (build #55001) – released 2018-12-24

Today's update fixes an issue surrounding generation of Symmetric and Secret Keys.

Improvements

• Improved randomness in key generation.

Fixed

• Secret Keys are now generated properly in all cases.

0.5.4  (build #54001) – released 2018-09-25

Today's update is all about performance! op get item should perform up to 5x better, especially on low powered systems.

Improvements

• op get item performance improved up to 5x.
• TOTP codes with some less common options are now supported.

0.5.3  (build #53001) – released 2018-08-20

An error with the signin command bring us today's update, ensuring those new to the command-line tool are able to set up the tool without fear.

Fixed

• An error with the previous update prevented new users from setting up the command-line tool, that has been resolved.

0.5.2  (build #52001) – released 2018-08-15

And we are back with more interstellar wisdom! Standby for a full transmission…

Improvements

• When `op signin` is run with an invalid shorthand/subdomain, a list of previously saved shorthands will be displayed.
• When signing in to a new account, a user will be prompted for the Secret Key if none is passed as an argument.

Fixed

• `op signin` no longer accepts `` as an argument via command line.
• Fixes error message when using short-form `op signin` command.

0.5.1  (build #51001) – released 2018-07-20

Hello earthlings! We are beaming to you more bug fixes and improvements. See the full transmission below for details!

Improvements

• Use XDG_CONFIG_HOME environment variable to determine where to store config files.
• When signing in with `op signin`, the latest signed in account will be used when no account name is specified.
• When signing in, the protocol (https://) is no longer needed when choosing account by domain.

Fixed

• Signing into a new account with the same domain would fail.

0.5  (build #50001) – released 2018-07-10

We're back with a fresh update hot from the oven. We've got a new command, some bug fixes for our Windows friends, as well as some general stability improvements for all. Check out the release notes below for all the details!

New

• Added `op delete trash` command to empty the trash for a vault.

Fixed

• The CLI will now handle errors related to two-factor authentication with aplomb.
• Windows users will no longer encounter occasional 403 errors while trying to sign in.

0.4.1  (build #41001) – released 2018-05-10

This command-line tool update is coming to you live from a wonderful patio under the sun, keeping everything running in tip-top shape. You can see everything we've changed since v0.4 in the release notes below!

Improvements

• A more accurate error will now be output when authentication with Duo is denied.
• The method of adding users to groups has been made more efficient.

Fixed

• TOTP codes whose secret specifies a particular algorithm are now generated correctly.
• Flags passed into op are no longer matched incorrectly because they are a prefix of another flag.

0.4  (build #40001) – released 2018-04-04

It's time for another command-line tool beta! On this bright and sunny, but still unseasonably cold April afternoon we're bringing you some new commands and a bevy of improvements and bug fixes. Let's see what's new!

New

• Added the `op edit user` command with the ability to change a user's first and last names.
• Added the `op edit group` command with the ability to edit the group's name and description.
• Added the `op get group` command to get details about a group.
• Added support for Duo and TOTP multi-factor authentication when signing into your 1Password account.

Improvements

• `op get item` now returns only non-trashed items, unless the new `--include-trash` flag is passed.
• Added type and state fields to the `op list users` output.
• The `op list documents` output is now more detailed.
• Help text across the tool is now much clearer.
• Made certain confusing error messages more friendly.

Fixed

• The `--vault` flag on `op get document` now works as expected.
• Older document files will now download correctly without any changes needed.
• op will now work correctly on systems with no user UIDs, in Alpine Docker containers for example.
• The proper OS version is now reported to the 1Password server when using Windows, macOS, Ubuntu, Fedora, openSUSE, FreeBSD, NetBSD, OpenBSD, or Solaris.
• One-time passwords with secrets of a non-standard length will now be displayed correctly.

0.3  (build #30001) – released 2018-02-13

Come one, come all! Version 0.3 of the 1Password command line tool has arrived! Today, we are bringing you a new command that will help in your item deleting quests, along with some improvements for all to enjoy. See the full changelog for details.

New

• [NEW] Added the ability to delete items with `op delete item <item> [--vault] `
• Multiple user accounts on a single system will now be able to use op independently

Improvements

• Updated some prompts and error messages to improve clarity and consistency
• Made improvements to the way request IDs are generated to ensure compatibility with future 1Password server updates
• Updated the use of the `X-AgileBits-MAC` HTTP header to ensure compatibility with future 1Password server updates

0.2.1  (build #21001) – released 2018-01-22

Hello friends, today we are back with some bug fixes related to version 0.2. Notably, we fixed the issue where `op list items` could fail on vaults where access was granted via group membership. See the full changelog below for details!

Improvements

• The list users output is now more concise, with 50% less empty fields.

Fixed

• Fixed issue where vaults accessed via a group membership would be inaccessible.
• Fixed issue where attempting to upload a file smaller than 16 bytes would fail.

0.2  (build #20001) – released 2017-12-01

Hello friends! We are coming back after some time off with a brand new feature release of the 1Password Command Line Interface. We've been hard at work delving deep into the code that powers this tool to make future releases that much quicker. Not only that, we have some brand new features, improvements, and fixes for you to enjoy, including some new commands! Let's see what's new:

New

• Added the create group command
• Added the delete group command
• Added the add command to give users access to vaults and groups
• Added the remove command to remove user access from vaults and groups
• Added the delete vault command
• Added builds for Solaris

Improvements

• op is now built with the latest version of the Go language
• The signout command will now correctly output an error when you are not signed in to begin with
• Vault names are now included in the list vaults command output
• Made the output from the update command clearer
• The get totp command is now much more reliable thanks to better decoding of TOTP secrets
• The get totp command now supports the 'period' parameter for codes that don't last 30 seconds

Fixed

• Changing the email address on your 1Password account will now automatically update your CLI config file
• Changing the subdomain on your Teams account will now automatically update your CLI config file
• CLI utility commands such as --version and --help will now output to stdout rather than stderr
• CLI utility commands now return a 0 status rather than an error status
• Removed newline from get document output, ensuring document integrity checks pass
• Vault that you manage but do not have read access to will no longer cause the list items or list vaults commands to crash

0.1.1  (build #11001) – released 2017-09-07

Greetings public beta testers! We'd like to thank you for an amazing launch with 0.1 yesterday. We've started getting some great feedback and we love seeing all the great things you're doing with the tool.
We've got a nice little bug hunt for you today with a few issues caught by you fine people in the first 24 hours after launch. An issue with signing in, an issue for users with a high permission set value, and some typos in our help text. Download now and enjoy! Full release notes below.

Fixed

• Some of you noticed a typo or two in the tool's help text. Edited, they have been!
• Users with a hyphen in their account's subdomain have had issues setting the environment variable for maintining sessions. These will now be automagically replaced with underscores.
• Users with a high permissions value would be overflowing our lowly integers. This now has 64 bits of error-free address space.

0.1  (build #10001) – released 2017-09-06

Hello, and welcome to the 1Password Command Line Interface Public Beta! It's been a great few months of testing by our lovely private beta community, and today we're excited that `op` is ready for the masses... to test!
This build is almost identical to v0.0.5 with a few under-the-hood tweaks, and it is ready for prime-time! Remember, any feedback you may have can be directed to our discussion forums, or to support+cli[at]agilebits.com. Happy beta everyone!

Fixed

• Updated the way the CLI identifies itself to the 1Password.com API to ensure future compatibility

0.0.5  (build #5) – released 2017-08-25

Hello and welcome to the 1Password Command Line Interface's second release candidate for public beta! In the short week since our last release we've squashed a few small bugs and made a few improvements! Read all about it below, and download now to try it out!.

Improvements

• The `op delete user` command would previously output an unhelpful server error when trying to delete a user that is not suspended. The message is now much friendlier.
• The `op create vault`, `op create item`, and `op create document` commands now output JSON with some extra information about the object created, rather than a lonely UUID.

Fixed

• The pubKey field from the `op list groups` command was AWOL. We brought it back safe and sound.
• The `op reactivate` command was being greedy and expecting 2 arguments when 1 would suffice. This has been resolved.
• When creating an item, op would set some optional fields as null rather than empty, which would cause the other apps in the family to get a little queasy. This has been resolved.

0.0.4  (build #4) – released 2017-08-25

Welcome to our public beta release candidate! It's been a little over a month since our last release and oh the times, they are a' changin'! We've got some massive improvements to share with you.

Firstly, we have a new signin flow! We've started saving session tokens into environment variables so you can save your session and use `op` without needing to pass the session token into every command! Yay! Run a quick eval $(op signin [shorthand]) to save your 30 minute session token!
Of course, you can still do things the old way if you wish, using the --session=[token] flag on any command, or by passing the token to stdin as before.

We also have some great improvements to getting and listing items. `op list items` will now show much more than a list of UUIDs. You'll get a nice overview of each item including the title and URLs!
In addition, `op get item` now includes WAY more information. Run it to find out just how much :)

Read on to see all the fixes, improvements and features we've added!

New

• `op signin` now outputs a command to save session tokens into environment variables
• Added the `--shorthand` flag to the signin command to allow multiple users from the same account
• Added the `--session` flag to all commands to keep backwards-compatibility with old authentication style (see --output=raw below)
• Added `op update` command to check for new versions
• Added `list templates` command to view all available item templates
• Added `--title`, `--url`, and `--tags` flags to the `create item` command

Improvements

• `op` now handles TOTP codes much more robustly
• Improvements to our SRP server-client verification protocol
• The delete command is now a properly formatted CLI subcommand
• Added help text to top-level commands
• All optional parameters have been converted to flags
• Added the `--output=raw` flag to the signin command to get a raw session token
• Item, Template, and Vault names, as well as item URLs are now case insensitive
• The `get item`, `list items`, and `list documents` commands now show far more information, including URLs and item titles

Fixed

• The `--vault` flag was previously causing an error when used with the `list documents` command, this has been resolved

0.0.3  (build #3) – released 2017-07-18

Welcome to the last alpha build before our public beta release candidate cycle begins! We've completely overhauled the command structure of op, grouping commands into several categories: create, get, and list. You can use these commands with items, vaults, groups, users, and more!. Use the --help flag on any of these new top-level commands to see what's available.
We also now have support for creating ANY item type! Now you can create anything from Logins to Wireless Router items.
Also new to go along with this release is our official documentation! . You can learn how to get everything up and running, and see all the options for your favorite commands.
One last change that's important to mention is that creating new items now requires the use of the new `op encode` command. Simply pass your item JSON into `op encode` via stdin (pipe works best), and you'll recieve the encoded data needed for `op create item`.

New

• op now includes an `encode` command for getting your item JSON ready for `op create item` {op-115}

Improvements

• op now has a new and improved command structure! Run `op --help` to learn more. {op-116}
• op now supports creating all item types! {op-113}

0.0.2  (build #2) – released 2017-05-31

In this build of op we are improving the security of our logging. Logs now output to /dev/null, and are set to the `errors` level by default. These can be changed with the `--log-output` and `--log-level` flags.

Improvements

• Improved logging practices and defaults

0.0.1  (build #1) – released 2017-05-19

In this build we are adding the ability to upload documents along with some security improvements.

New

• Added ability to upload documents with the "op document upload {session} {path}" command with an optional "--vault={vault name or uuid}" flag

Improvements

• Added document file integrity checking when downloading a file