# Bitrise Plugins :io - Command Line / Terminal interface for bitrise.io to manage your apps on bitrise.io right from your terminal / command line

**URL:** <https://discuss.bitrise.io/t/bitrise-plugins-io-command-line-terminal-interface-for-bitrise-io-to-manage-your-apps-on-bitrise-io-right-from-your-terminal-command-line/5132>\
**Category:** Beta Testing\
**Tags:** cli\
**Created:** [May 21, 2018, 9:11am UTC](https://discuss.bitrise.io/t/bitrise-plugins-io-command-line-terminal-interface-for-bitrise-io-to-manage-your-apps-on-bitrise-io-right-from-your-terminal-command-line/5132 "2018-05-21T09:11:14Z")\
**Posts on this page:** 13\
**Page:** 1

<div class="post-metadata">

**Author:** ![viktorbenei](https://sea2.discourse-cdn.com/flex016/user_avatar/discuss.bitrise.io/viktorbenei/32/18_2.png) [@viktorbenei](https://discuss.bitrise.io/u/viktorbenei)\
**Post date:** [May 21, 2018, 9:11am UTC](https://discuss.bitrise.io/t/bitrise-plugins-io-command-line-terminal-interface-for-bitrise-io-to-manage-your-apps-on-bitrise-io-right-from-your-terminal-command-line/5132/1 "2018-05-21T09:11:14Z")

</div>

A Terminal / Command Line interface for [bitrise.io](http://bitrise.io), to manage your apps on [bitrise.io](http://bitrise.io) right from your terminal / command line.

Source code: [https://github.com/bitrise-core/bitrise-plugins-io](https://github.com/bitrise-core/bitrise-plugins-io)

Related #feature-request : [Use bitrise-cli to build a mobile app like heroku does / A Terminal / Command Line interface for bitrise.io, to manage your apps on bitrise.io right from your terminal / command line](http://discuss.bitrise.io/t/use-bitrise-cli-to-build-a-mobile-app-like-heroku-does/4966)

---

<div class="post-metadata">

**Author:** ![viktorbenei](https://sea2.discourse-cdn.com/flex016/user_avatar/discuss.bitrise.io/viktorbenei/32/18_2.png) [@viktorbenei](https://discuss.bitrise.io/u/viktorbenei)\
**Post date:** [May 10, 2018, 10:57am UTC](https://discuss.bitrise.io/t/bitrise-plugins-io-command-line-terminal-interface-for-bitrise-io-to-manage-your-apps-on-bitrise-io-right-from-your-terminal-command-line/5132/5 "2018-05-10T10:57:20Z")

</div>

The latest version on the `master` branch can do the following things:

```auto
$ bitrise-plugins-io --help

Bitrise IO plugin

Usage:
  bitrise-plugins-io [command]

Available Commands:
  apps Get apps for user
  auth Authenticate
  builds Get builds for app
  help Help about any command
  log Get log of build
  version Print version

Flags:
  -h, --help help for bitrise-plugins-io

Use "bitrise-plugins-io [command] --help" for more information about a command.

```

---

<div class="post-metadata">

**Author:** ![viktorbenei](https://sea2.discourse-cdn.com/flex016/user_avatar/discuss.bitrise.io/viktorbenei/32/18_2.png) [@viktorbenei](https://discuss.bitrise.io/u/viktorbenei)\
**Post date:** [May 21, 2018, 9:13am UTC](https://discuss.bitrise.io/t/bitrise-plugins-io-command-line-terminal-interface-for-bitrise-io-to-manage-your-apps-on-bitrise-io-right-from-your-terminal-command-line/5132/6 "2018-05-21T09:13:39Z")

</div>

Working on the new `builds` list command, using Go’s [tabwriter · pkg.go.dev](https://golang.org/pkg/text/tabwriter/) & some coloring:

 ![24](https://us1.discourse-cdn.com/flex016/uploads/bitrise/original/2X/f/f5eb7263632f70f3ff333bff2a13d99e723c6ec5.png)

---

<div class="post-metadata">

**Author:** ![viktorbenei](https://sea2.discourse-cdn.com/flex016/user_avatar/discuss.bitrise.io/viktorbenei/32/18_2.png) [@viktorbenei](https://discuss.bitrise.io/u/viktorbenei)\
**Post date:** [May 21, 2018, 9:19am UTC](https://discuss.bitrise.io/t/bitrise-plugins-io-command-line-terminal-interface-for-bitrise-io-to-manage-your-apps-on-bitrise-io-right-from-your-terminal-command-line/5132/7 "2018-05-21T09:19:23Z")

</div>

Yesterday I worked on the `apps` list command. Not sure yet whether the formatter output should use tabwriter here as well 🤔

 ![52](https://us1.discourse-cdn.com/flex016/uploads/bitrise/original/2X/4/4e3247d10fea0a383d13422b2dcce80f5160ecb4.png)

---

<div class="post-metadata">

**Author:** ![viktorbenei](https://sea2.discourse-cdn.com/flex016/user_avatar/discuss.bitrise.io/viktorbenei/32/18_2.png) [@viktorbenei](https://discuss.bitrise.io/u/viktorbenei)\
**Post date:** [May 27, 2018, 7:41am UTC](https://discuss.bitrise.io/t/bitrise-plugins-io-command-line-terminal-interface-for-bitrise-io-to-manage-your-apps-on-bitrise-io-right-from-your-terminal-command-line/5132/8 "2018-05-27T07:41:53Z")

</div>

Update: just published:

> <https://github.com/bitrise-io/bitrise-plugins-io/issues/35>
>
> Right now if an \`Unauthorized\` error happens the plugin just prints the fact. If… you run the command (e.g. \`apps\`) 5 times you get the same 5 times.
> 
> Due to the fact that if you get an unauthorized then that means the credentials are not valid and regardless of how many times you try it again you'll get the same results, my proposal is to:
> 
> \- Print the \`Unauthorized\` error when it happens
> \- Clear out the token if set (most likely expired or it was revoked)
> \- Print instructions about how to get/register a new one

A revision of what happens if the Personal Access Token expires or is revoked. In short previously the tool just printed the fact without any further steps or help.

From now it prints the fact but also clears out the PAT stored locally, as well as prints at least some guidance what you can do to remediate the issue:

 ![02](https://us1.discourse-cdn.com/flex016/uploads/bitrise/original/2X/c/cc097bc15b2ff81caf5067978618cb0412c15814.png)

And if you’d try the command again, instead of just another “Unauthorized” message you’ll get:

 ![38](https://us1.discourse-cdn.com/flex016/uploads/bitrise/original/2X/5/598afee0c19ab5c1bbcb891cbc28e30ddcb07e16.png)

---

<div class="post-metadata">

**Author:** ![viktorbenei](https://sea2.discourse-cdn.com/flex016/user_avatar/discuss.bitrise.io/viktorbenei/32/18_2.png) [@viktorbenei](https://discuss.bitrise.io/u/viktorbenei)\
**Post date:** [May 27, 2018, 8:06am UTC](https://discuss.bitrise.io/t/bitrise-plugins-io-command-line-terminal-interface-for-bitrise-io-to-manage-your-apps-on-bitrise-io-right-from-your-terminal-command-line/5132/9 "2018-05-27T08:06:23Z")

</div>

Working on some enhancement for the `browse` command as well:

> <https://github.com/bitrise-io/bitrise-plugins-io/issues/36>
>
> In case the opening in browser would not work.
> 
> Also add a flag option to not …to open the link in browser just print it out, in case someone doesn't want to open it in the primary browser.

It introduces two things:

1. Print the URL **before** attempting to open it in a web browser, so that even if the open would fail you can find the URL in the log and copy paste it manually
2. Introduced a new flag (`--open=false`) to **not to open** the URL in the web browser. This mode simply just prints the URL but does not attempt to open it.

`--open=true`:

 ![47](https://us1.discourse-cdn.com/flex016/uploads/bitrise/original/2X/d/d27606fbfa1a6395429e2305b10d7dd04e2b3f35.png)

`--open=false`:

 ![29](https://us1.discourse-cdn.com/flex016/uploads/bitrise/original/2X/e/ea2785a53ad434930af2fab9ecf3249d1f624786.png)

---

<div class="post-metadata">

**Author:** ![viktorbenei](https://sea2.discourse-cdn.com/flex016/user_avatar/discuss.bitrise.io/viktorbenei/32/18_2.png) [@viktorbenei](https://discuss.bitrise.io/u/viktorbenei)\
**Post date:** [June 10, 2018, 6:09pm UTC](https://discuss.bitrise.io/t/bitrise-plugins-io-command-line-terminal-interface-for-bitrise-io-to-manage-your-apps-on-bitrise-io-right-from-your-terminal-command-line/5132/10 "2018-06-10T18:09:35Z")

</div>

Working on publishing a new release of the plugin, after some readme and setup guide revisions.

---

<div class="post-metadata">

**Author:** ![viktorbenei](https://sea2.discourse-cdn.com/flex016/user_avatar/discuss.bitrise.io/viktorbenei/32/18_2.png) [@viktorbenei](https://discuss.bitrise.io/u/viktorbenei)\
**Post date:** [June 10, 2018, 6:41pm UTC](https://discuss.bitrise.io/t/bitrise-plugins-io-command-line-terminal-interface-for-bitrise-io-to-manage-your-apps-on-bitrise-io-right-from-your-terminal-command-line/5132/11 "2018-06-10T18:41:18Z")

</div>

Version `0.0.4` was just released: [https://github.com/bitrise-core/bitrise-plugins-io/releases/tag/0.0.4](https://github.com/bitrise-core/bitrise-plugins-io/releases/tag/0.0.4)

Includes all the recent revisions, and can now be installed directly via the `bitrise` cli:

```auto
bitrise plugin install https://github.com/bitrise-core/bitrise-plugins-io.git --version=0.0.4

```

---

<div class="post-metadata">

**Author:** ![viktorbenei](https://sea2.discourse-cdn.com/flex016/user_avatar/discuss.bitrise.io/viktorbenei/32/18_2.png) [@viktorbenei](https://discuss.bitrise.io/u/viktorbenei)\
**Post date:** [June 10, 2018, 6:49pm UTC](https://discuss.bitrise.io/t/bitrise-plugins-io-command-line-terminal-interface-for-bitrise-io-to-manage-your-apps-on-bitrise-io-right-from-your-terminal-command-line/5132/12 "2018-06-10T18:49:54Z")

</div>

README revisions: [https://github.com/bitrise-core/bitrise-plugins-io/pull/41](https://github.com/bitrise-core/bitrise-plugins-io/pull/41)

---

<div class="post-metadata">

**Author:** ![viktorbenei](https://sea2.discourse-cdn.com/flex016/user_avatar/discuss.bitrise.io/viktorbenei/32/18_2.png) [@viktorbenei](https://discuss.bitrise.io/u/viktorbenei)\
**Post date:** [June 16, 2018, 4:57pm UTC](https://discuss.bitrise.io/t/bitrise-plugins-io-command-line-terminal-interface-for-bitrise-io-to-manage-your-apps-on-bitrise-io-right-from-your-terminal-command-line/5132/13 "2018-06-16T16:57:49Z")

</div>

`browse` command can now open a specified build directly: [https://github.com/bitrise-core/bitrise-plugins-io/pull/43](https://github.com/bitrise-core/bitrise-plugins-io/pull/43)

---

<div class="post-metadata">

**Author:** ![viktorbenei](https://sea2.discourse-cdn.com/flex016/user_avatar/discuss.bitrise.io/viktorbenei/32/18_2.png) [@viktorbenei](https://discuss.bitrise.io/u/viktorbenei)\
**Post date:** [June 16, 2018, 5:01pm UTC](https://discuss.bitrise.io/t/bitrise-plugins-io-command-line-terminal-interface-for-bitrise-io-to-manage-your-apps-on-bitrise-io-right-from-your-terminal-command-line/5132/14 "2018-06-16T17:01:24Z")

</div>

Also working on `artifact` commands: [https://github.com/bitrise-core/bitrise-plugins-io/pull/42](https://github.com/bitrise-core/bitrise-plugins-io/pull/42)

You can now:

- `artifact list` to get a list of artifacts (for a specific build)
- `artifact show` to show data of a specified artifact, including the download URL
- and `artifact download` which “downloads” the artifact. It can only print for now but that can be piped into a file, as well as I’ll add an option to save into file directly once I have some time to finish it 😉

---

<div class="post-metadata">

**Author:** ![viktorbenei](https://sea2.discourse-cdn.com/flex016/user_avatar/discuss.bitrise.io/viktorbenei/32/18_2.png) [@viktorbenei](https://discuss.bitrise.io/u/viktorbenei)\
**Post date:** [June 18, 2018, 8:16pm UTC](https://discuss.bitrise.io/t/bitrise-plugins-io-command-line-terminal-interface-for-bitrise-io-to-manage-your-apps-on-bitrise-io-right-from-your-terminal-command-line/5132/15 "2018-06-18T20:16:12Z")

</div>

`artifacts list` now uses a tabbed / table based output like `builds`:

 ![Screenshot%20from%202018-06-18%2022-16-08](https://us1.discourse-cdn.com/flex016/uploads/bitrise/original/2X/c/c5a5fbd07392782f671cd56f68c9cf29bbe1db2c.png)

---

<div class="post-metadata">

**Author:** ![viktorbenei](https://sea2.discourse-cdn.com/flex016/user_avatar/discuss.bitrise.io/viktorbenei/32/18_2.png) [@viktorbenei](https://discuss.bitrise.io/u/viktorbenei)\
**Post date:** [June 19, 2018, 10:36am UTC](https://discuss.bitrise.io/t/bitrise-plugins-io-command-line-terminal-interface-for-bitrise-io-to-manage-your-apps-on-bitrise-io-right-from-your-terminal-command-line/5132/16 "2018-06-19T10:36:49Z")

</div>

Released [`v0.0.5`](https://github.com/bitrise-core/bitrise-plugins-io/releases/tag/0.0.5) which includes:

- browse command new flag: build - to open specific build ([#43](https://github.com/bitrise-core/bitrise-plugins-io/pull/43))
- Artifacts commands: list, show, download - ([#42](https://github.com/bitrise-core/bitrise-plugins-io/pull/42))

Can be installed with:

```auto
bitrise plugin install https://github.com/bitrise-core/bitrise-plugins-io.git --version=0.0.5

```