Managing projects

You can manage your projects from the terminal with the collingo projects command. Use it to list your projects, create new ones, update their data, or delete them. Projects are the top-level container for your translation data; next you typically add groups and entries.

List projects

To see all projects you have access to, run:

collingo projects list

You can also use the alias ls: collingo projects ls.

The command prints one line per project in the form [id] name and, for projects you own, (owner) after the name. Use the id from this output when you call update or delete with flags.

Create a project

To create a new project, run:

collingo projects create

Alias: add.

You can pass the project name with a flag, or the CLI will ask you for it:

Project name: Set with --name <name>, or omit the flag and you will be asked to enter a name.
Base language: There is no flag. You are always asked to select a base language (e.g. en-US) interactively.
Translation languages: There is no flag. You are then asked to add translation languages in an interactive multi-select.

Example with the name given by flag (language selection is still interactive):

collingo projects create --name "My App"

When the project is created, the CLI prints the new project name and its id.

Update a project

To change a project’s data (currently only its name), run:

collingo projects update

Alias: edit.

Parameters:

The ID of the project to edit: Set with --project <id> (use an id from collingo projects list), or omit the flag and you will be asked to choose a project interactively.
The new name: Set with --name <name>, or omit and you will be asked whether to update the name and then prompted for the new value.

Example with all values passed by flags:

collingo projects update --project <id> --name "New Name"

If there is nothing to update, the CLI prints “Nothing to update”.

Delete a project

To delete a project, run:

collingo projects delete

Alias: rm.

Parameters:

The ID of the project to delete: Set with --id <id> (use an id from collingo projects list), or omit the flag and you will be asked to choose a project interactively.
Skip confirmation: Set --yes to delete without being asked. If you omit it, the CLI shows the project and asks you to confirm.

Example without confirmation prompt:

collingo projects delete --id <id> --yes

Deleting a project is irreversible and removes the project and its data.

Working directory

If you run the CLI from a different directory and need to use a specific workspace config, you can pass the global flag --working-dir <dir> to set the working directory. This applies to all commands, including projects.