Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Mirrored from https://github.com/Camo67/composio.git
Synced Nov 21, 03:37 UTC
| 1 | --- |
| 2 | title: "CLI Improvements: Login, Link, and Whoami" |
| 3 | description: "Interactive org/project picker, --no-wait for link, and whoami no longer exposes API keys" |
| 4 | date: "2026-03-13" |
| 5 | --- |
| 6 | |
| 7 | This release improves the Composio CLI with a better login flow, a non-blocking link option, and improved security for the whoami command. |
| 8 | |
| 9 | ### CLI Version |
| 10 | |
| 11 | | Package | Version | |
| 12 | |---------|---------| |
| 13 | | @composio/cli | v0.2.2 | |
| 14 | |
| 15 | --- |
| 16 | |
| 17 | ## What's New |
| 18 | |
| 19 | ### Interactive Org/Project Picker After Login |
| 20 | |
| 21 | `composio login` now prompts you to select your default organization and project after the browser OAuth flow completes. |
| 22 | |
| 23 | - **Default behavior**: After login, you see an interactive picker to choose your org and project. If you have only one org and one project, they are auto-selected. |
| 24 | - **With `-y`**: Skip the picker and use the session defaults (e.g. for CI or scripts). |
| 25 | |
| 26 | ```bash |
| 27 | composio login # Login, then pick org/project |
| 28 | composio login -y # Login, use session defaults (no picker) |
| 29 | composio login --no-browser # Print URL, don't open browser |
| 30 | ``` |
| 31 | |
| 32 | ### Non-Interactive Link with `--no-wait` |
| 33 | |
| 34 | `composio link` now supports a `--no-wait` flag for non-blocking authorization flows. |
| 35 | |
| 36 | - **Default**: Opens the browser and waits until the connected account is ACTIVE. |
| 37 | - **With `--no-wait`**: Prints link info and JSON to stdout (JQ-parseable) and exits immediately. Useful for scripts and CI. |
| 38 | |
| 39 | ```bash |
| 40 | composio link github # Opens browser, waits for completion |
| 41 | composio link github --no-wait # Prints redirect URL and JSON, exits |
| 42 | ``` |
| 43 | |
| 44 | ### Whoami No Longer Exposes API Keys |
| 45 | |
| 46 | The `composio whoami` command no longer displays API keys in the output. This improves security and reduces the risk of accidental exposure in logs or screenshots. |
| 47 | |
| 48 | - API key is removed from both display and JSON output. |
| 49 | - Hints for `composio manage orgs switch` and `composio init` are shown instead. |
| 50 | |
| 51 | --- |
| 52 | |
| 53 | ## Breaking Changes |
| 54 | |
| 55 | ### Removed Flags from Login and Init |
| 56 | |
| 57 | The following flags have been removed from `composio login` and `composio init`: |
| 58 | |
| 59 | - `--api-key` |
| 60 | - `--org-id` |
| 61 | - `--project-id` |
| 62 | |
| 63 | <Callout type="warn"> |
| 64 | **Breaking Change** |
| 65 | |
| 66 | If you previously used `composio login --api-key uak_xxx --org-id X --project-id Y` for non-interactive login (e.g. in CI), you must use the browser-based flow instead. Use `composio login -y` to skip the org/project picker and accept session defaults. |
| 67 | |
| 68 | For `composio init`, the `--org-id` and `--project-id` flags are removed. Use `composio init` interactively, or run `composio login` first and then `composio init`. |
| 69 | </Callout> |
| 70 | |
| 71 | **Before:** |
| 72 | ```bash |
| 73 | composio login --api-key uak_xxx --org-id org_123 --project-id proj_456 |
| 74 | composio init --org-id org_123 --project-id proj_456 |
| 75 | ``` |
| 76 | |
| 77 | **After:** |
| 78 | ```bash |
| 79 | composio login -y # Login with session defaults (no picker) |
| 80 | composio init # Interactive project selection |
| 81 | ``` |
| 82 | |
| 83 | --- |
| 84 | |
| 85 | ## Improvements |
| 86 | |
| 87 | - **Login JSON output**: When using the org/project picker, the JSON output now reflects the final selection (not the initial session state). |
| 88 | - **Picker error handling**: If the org/project picker fails (e.g. API error), the CLI shows a warning, emits JSON with session data, and displays hints so you are not left without guidance. |
| 89 | - **Modularized org/project selection**: The selection logic is shared between `composio login` and `composio manage orgs switch`. |