Manual 0.8.0

Reuse one connection across projects

State one credential and address for the whole instance. Every project that states none of its own reads the tool through that one.

Before you start

Configuration page

  1. Open the configuration page. If it is not open, run revetly config and open the address it prints.

  2. Turn on Advanced settings.

    You should see Connections.

  3. Go to Instance settings > Connections.

  4. Select Add connection.

    You should see Todoist among the tools offered.

  5. Choose Todoist.

  6. Enter the variable the token is read from in API token variable. Revetly reads the token from that variable rather than from the file.

  7. Enter the token Todoist issued you in Key for the todoist connector. Revetly writes it to the .env beside revetly.toml, never into the committed file.

  8. Select Save.

    You should see token set on the connection line.

  9. On the card of the project that reads through it, select Add source.

  10. Choose the Todoist row marked the instance's connection.

    You should see Test connection on the new source.

  11. Select Save.

    You should see the instance's connection on that source's line.

  12. Select Test connection on that source's line. Revetly answers with what it reached, and puts any advice after it.

    You should see api.todoist.com answers; … on that source.

Command line

  1. In revetly.toml at the project root, state the connection once under [connectors.todoist]:

    # revetly.toml
    [connectors.todoist]
    token_env = "TODOIST_API_TOKEN"
    
  2. In .env beside it, put the token that variable names:

    # .env
    TODOIST_API_TOKEN=<TODOIST_TOKEN>
    

    Replace <TODOIST_TOKEN> with the token Todoist issued you.

  3. In revetly.toml, add the source to the project that reads through it:

    # revetly.toml
    [projects.beta.connectors]
    enabled = ["pm", "docs", "conversations", "deliveries", "todoist"]
    
  4. Confirm whose connection that project runs on:

    revetly doctor --offline --all
    
    [PASS] beta: todoist: connection   the instance's connection — …
    
  5. Confirm the tool answers on that credential:

    revetly doctor --all
    

    You should see api.todoist.com answers; <COUNT> project(s) visible in the terminal.

Troubleshooting

Next steps